船讯网-API

API是什么

API是Application Program Interface的缩写，即应用程序接口。船讯网API是一组JavaScript函数，使用这些函数您可以回避专业而复杂的GIS技术而简单便捷地把船讯网的海图和船位服务嵌入到您自己的业务系统或网站中，在电子海图背景上展现船位并进行管理，甚至是与您自己的业务数据相融合。站在用户的角度看，这些功能和应用就像是您系统原生的一样。大家熟知很多网站上都有地图功能，而这些功能往往都不是自己开发的，而是使用第三方地图服务API快速构建的，比如著名的GoogleMap API，船讯网API的应用模式和技术架构与之非常类似。
一套获取船舶AIS数据的接口和方法：
1、获取单条或多条船舶最新AIS数据；
2、获取指定区域内的所有船舶最新AIS数据；
3、获取某船舶的历史轨迹；
4、通过船舶类型等属性查询船舶；
一套基于WebGIS的展示船舶动态的方法：
1、提供基于电子海图/地图的船位显示功能；
2、支持电子海图、谷歌地图、谷歌卫星图三种背景图的选择（使用海图需向海图出版商支付版权费用）；
3、区域监控，提供一个或多个区域的全部船舶监控服务，支持多条件筛选；
4、船队监控，提供一组船舶在全球范围内的船位监控服务。支持任意更改船舶、船队分组，船舶自定义颜色显示等；
5、全球船舶搜索，支持通过船名、呼号、MMSI、IMO等条件搜索，结果返回在电子海图上；
6、支持在API中添加超链接，添加自有业务信息等；
7、支持船舶AIS信息显示，支持通过船名、呼号、IMO编号、区域范围等条件获取AIS原始数据；
8、支持查看船舶30天历史轨迹；
9、支持在海图/地图上添加文字、图片、线型等标注信息；
10、提供基于GIS应用的图上测距功能。

典型应用

我们开发了两种典型的应用案例，使用这两种应用案例，用户无需做任何的开发，只需要将页面嵌入自己的网站即可。
1. 区域监控
主要是针对某些港口用户，需要掌握一片区域内所有船舶的运动状态。区域监控主要提供以下功能：
-- 通过船名、呼号、IMO、MMSI编号查询全球范围内的船；
-- 全部显示本区域内的船舶；
-- 根据船籍、船舶类型、货物类型、船舶状态、船长、船宽、吃水等条件筛选符合条件的船；
-- 查看船舶历史轨迹。
-- 接入第三方船舶数据。
在线体验» 源码下载»
2. 船队监控
主要是针对船东或者船舶服务企业，需要掌握一组船舶或者不固定船舶的运动状态。
(1) 船队监控页面
该页面是船队监控网站的前台页面，主要提供以下功能：
-- 通过船名、呼号、IMO、MMSI编号查询全球范围内的船；
-- 只显示本船队的船；
-- 查看船舶历史轨迹。
在线体验» 源码下载»
(2) 船队管理系统
船队管理系统是船队监控网站的后台管理工具，主要提供以下功能：
-- 自由更改船队中的船舶；
-- 船队自由分组，船舶颜色自定义显示；
进入系统» 源码下载»

面向的读者

本文档适合于熟悉JavaScript语言及面向对象编程概念的读者。对于只熟悉HTML语言和简单JavaScript的用户，可以联系船讯网技术支持寻求帮助。

1. 将API嵌入到自己的网站中
-- 复制下列代码到自己的网站中
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>显示地图</title> <style type="text/css"> html, body{ height:100%; margin:0; padding:0;} #mapDiv{ width:500px; height:400px; background-color:#EFF5FF;} </style> <script src="http://api.shipxy.com/apicall/index?api=map&key=1F6D701272402D1E7D8D316CCE519123&ver=1.3" type="text/javascript"></script> <script type="text/javascript"> var map; window.onload = function () { var mapOptions = new shipxyMap.MapOptions(); mapOptions.center = new shipxyMap.LatLng(32, 122); mapOptions.zoom = 5; mapOptions.mapType = shipxyMap.MapType.CMAP; //mapDiv是一个DIV容器的id，用于放置flash地图组件 map = new shipxyMap.Map('mapDiv', mapOptions); //创建地图实例 //地图初始化完毕 shipxyMap.mapReady = function () { //地图初始化完毕才能操作地图其他的接口 } } </script> </head> <body> <div id="mapDiv"></div> </body> </html>

AIS数据是什么

AIS数据是指装载在船舶上面的AIS设备自动发出的数据，它包含两部分信息，船名、呼号、MMSI、IMO、船长、船宽等静态信息和经纬度、船首向、航向、航速、目的地、ETA等动态信息。船讯网就是利用部署在沿岸的AIS基站接收这些数据，并结合海图，实现对船舶的定位跟踪。
船讯网AIS数据是一项新的业务，旨在向有需要的用户提供原始的AIS数据，以方便用户在自己的系统或网站中实现类似船讯网的船舶追踪功能。
主要功能：
1、提供船舶的AIS原始数据；
2、自由更改定制船舶；
3、数据更新频率与船讯网同步。

数据提供方式

船讯网通过WebService调用提供原始AIS数据，简单易用。
1、船队数据，提供一组船队的AIS数据，船舶可自由更改；
2、港口数据，提供一定区域内的AIS数据。

AIS数据与API的区别

1、AIS数据仅提供数据，而API还提供了数据与海图匹配的解决方案；
2、AIS数据可以自由更改船队，API不支持；
3、AIS数据在使用上比API相对灵活，更能满足个性化定制的需要。

AIS数据申请

如果您对AIS数据感兴趣或业务上有需要，请致电 010-8286 8386。
AIS数据说明文档和开发文档，请向API@shipxy.com索取。