《船讯网api功能说明》由会员分享，可在线阅读，更多相关《船讯网api功能说明（10页珍藏版）》请在金锄头文库上搜索。
1、 船讯网 API 功能说明文档 S 2012-9-24 船讯网是国内最专业的船舶位置监控网站，提供免费的全球船位追踪服务。但随着市场变化和用户需要， 越来越多客户希望能在自己的业务系统或者网站中集成船位追踪模块，达到船队安全管理和有效控制物流环节的目的。船讯网 API 旨在解决这一问题。 北京亿海蓝科技有限公司 -1- 船讯网船讯网 API 功能说明文档功能说明文档 1 API 是什么？是什么？ 1.1 API 定义定义 API 是 Application Program Interface 的缩写，即应用程序接口。船讯网 API 是一组JavaScript 函数，使用这些函数您可以回避专业
2、而复杂的 GIS 技术而简单便捷地把船讯网的海图和船位服务嵌入到您自己的业务系统或网站中， 在电子海图背景上展现船位并进行管理，甚至是与您自己的业务数据相融合。 1.2 船讯网船讯网 API 的的本本质质 船讯网 API 的本质是提供了一套如何获取船舶 AIS 数据的方法和一套如何在 WebGis上展示船舶的方法。 用户可以只获取船舶 AIS 数据，使用自己的方法显示船舶；也可以使用船讯网提供的WebGis 方法展示船舶。 1.3 船讯网船讯网 API 功能功能 （1） 一套获取船舶 AIS 数据的接口和方法 - 获取单条或多条船舶最新 AIS 数据； - 获取指定区域内的所有船舶最新 AIS
3、 数据； - 获取某船舶的历史轨迹； - 通过船舶类型等属性查询船舶。 （2） 一套基于 WebGIS 的展示船舶动态的方法 - 提供基于电子海图/地图的船位显示功能； - 支持电子海图、谷歌地图、谷歌卫星图三种背景图的选择（使用海图需向海图出版商支付版权费用） ； - 区域监控，提供一个或多个区域的全部船舶监控服务，支持多条件筛选； - 船队监控，提供一组船舶在全球范围内的船位监控服务。支持任意更改船舶、船北京亿海蓝科技有限公司 -2- 队分组，船舶自定义颜色显示等； - 全球船舶搜索，支持通过船名、呼号、MMSI、IMO 等条件搜索，结果返回在电子海图上； - 支持在 API 中添加超链接
4、，添加自有业务信息等； - 支持船舶 AIS 信息显示，支持通过船名、呼号、IMO 编号、区域范围等条件获取AIS 原始数据； - 支持查看船舶 30 天历史轨迹； - 支持在海图/地图上添加文字、图片、线型等标注信息； 2 典型应用典型应用 综合多种用户的使用需求，我们开发了两种典型的应用。使用这两种应用，原则上用户无需任何的开发，只需要将应用源码嵌入到自己的网站中就可以实现船位监控的目的。 2.1 区域监控区域监控应用应用 区域监控应用适合港口、码头、口岸、拖轮、海事、引航等港口企事业单位，实现在海图上监控本地区船舶动态的需要。 船讯网则按照用户的需要， 提供相应区域的 AIS 数据。区域
5、监控主要能够实现以下功能。 （1） 搜索、定位全球范围内的任意船舶 除查询本区域的船舶位置之外，还可以查询全球范围内的船舶位置。用户只要知道船名、呼号、MMSI、IMO 编号中的任意一种，即可获得该船位的位置，如下图所示。 图 1 全球范围内搜索船舶 北京亿海蓝科技有限公司 -3- 图 2 搜索结果展示 （2） 显示本地区的所有船舶 全球范围内的船舶需要查询才能显示，但是本地区的船舶，不需要查询就可以全部显示，如下图所示。 图 3 显示本地区船舶 （3） 筛选符合条件的船舶 由于在一个港区船舶的数量众多，用户可以设定条件，只显示本港区的符合某一条件的船舶，如下图所示。 北京亿海蓝科技有限公司
6、-4- 图 4 筛选显示条件 （4） 查看船舶的历史轨迹 无论船舶是否在本区域内，都可以查询任意船舶的历史轨迹，如下图所示。 图 5 回放船舶历史轨迹 （5） 区域监控应用样例 2.2 船队监控的应用船队监控的应用 船队监控的应用主要适合船东、船舶管理、货运代理、物流服务等用户，需要监控某些特定的船，或者监控一些数量的不特定的船。船讯网按照用户的需要，开发完成船队监控北京亿海蓝科技有限公司 -5- 应用，主要提供以下功能。 （1） 搜索、定位全球范围内的任意船舶 船队监控应用不仅可以监控本船队的船舶位置，还可以查询全球范围内的船舶位置。你只要知道船名、呼号、MMSI、IMO 编号中的任意一种，
7、即可获得该船位的位置，如下图所示。 图 6 查询全球船位 图 7 船位查询显示结果 （2） 船队分组、高亮、自定义颜色、自定义船名 用户可以根据自己的业务类型，进行对船队进行分组、高亮和自定义颜色、自定义船名等，如下图所示。 北京亿海蓝科技有限公司 -6- 图 8 船舶自定义分组 图 9 船舶分组显示效果 （3） 自由更改船队中的船舶 船讯网 API 中提供接口，用户可以根据自己的业务变化，随时添加、删除、变更船舶和分组。 （4） 查询任意船轨迹 API 提供数据请求接口，可调取任意船舶的 30 天的历史轨迹。 图 10 船舶轨迹显示 北京亿海蓝科技有限公司 -7- （5） 船队监控应用样例
8、3 自定义应用自定义应用 如果上述两种典型应用仍旧不能满足您的需求，您可以使用自定义应用模式。自定义模式，可以实现以下功能。 （1） 选择默认显示的地图中心点和缩放比例 在船讯网的 API 中，我们提供三种背景显示：海图，Google 地图，Google 卫星图。我们同时把地图的比例尺分成了 18 个等级， 用户可以根据自定的需要自行设定显示的范围，如下图所示。 图 11 海图/地图显示设置 （2） 查询全球船舶位置 用户通过船名、呼号、MMSI、IMO 编号等关键字，获取全球范围内的任意船舶的实施位置。 图 12 查询全球船舶位置 北京亿海蓝科技有限公司 -8- （3） 自由的获取船舶 AI
9、S 数据 - 单船 AIS 数据获取，每次获取单条船的 AIS 数据； - 船队 AIS 数据获取，每次获取一组船的 AIS 数据； - 区域 AIS 数据获取，每次获取一个区域范围内的 AIS 数据； （4） 船队监控和区域监控组合使用 用户可以根据需要， 将船队监控和区域监控相结合， 实现对监控区域内船舶进行分组、高亮、自定义显示。 图 13 船队监控与区域监控相结合 4 常见问题常见问题 FAQ (1) 我获得的船位是实时的吗? - 船讯网 API 提供的船位是从部署在港口附近的 AIS 基站中获取的。由于 AIS 基站的覆盖距离有限， 一般只能接收到港口附近 30-50 海里的数据。
10、但是由于船讯网的基站覆盖比较密集，已经完全覆盖了中国沿海的所有区域。 - 船讯网保证，用户通过 API 获得的船位与船讯网网站中的数据实时性是一致的。 (2) API 是如何收费的？ - AIS 数据部分，按照船舶的数量收费； 北京亿海蓝科技有限公司 -9- - 海图费用，向海图出版商支付版权费用（不选择海图，免付费） (3) 如何更改船队中的船舶 在 API 中，船队的船舶是以高亮的方式提供的。API 中已经预留了程序接口，用户可以根据自己的需要随时更改这些船舶。 (4) 如何更改区域 在 API 中，支持多个区域获取数据。但是区域的更改需要通过船讯网协调更改。 (5) 如何监控船队船舶周围的其他船舶 API 中接口，支持以本船为中心，获取本船周围的其他船舶数据，并显示出来。 (6) 如何自定义船舶信息框 在 API 中，船舶信息框是通过 javascript（一种计算机语言）控制的，这个信息可以完全由用户自定义开发。 (7) 如何设定到港提醒 在 API 中是没有到港提醒功能的，由于船讯网已经将船舶的原始数据通过 API 提供给了客户，可以自己根据原始数据开发到港提醒。根据船舶的地理位置信息，与设定目的地范围对比，符合条件的，给予提醒。
