1.服务简介#
船讯网提供的API接口服务是面向软件开发企业的一款基于Http请求的原始数据提供服务。该服务通过Http协议,为开发者提供船舶位置及相关动态数据的查询和推送功能。开发者可以通过船名、呼号、MMSI、IMO等信息获取船舶的动态数据,覆盖船舶查询、港口查询、历史行为、挂靠记录、航线规划、气象天气、海事数据、海图应用、监控推送等九大场景。2.服务架构#
服务架构基于Http请求,客户端通过API接口向服务器发送请求,服务器返回相应的船舶数据包。整个数据交互过程通过Http协议完成,支持Json和二进制Base64 编码等多种返回结果格式。3.主要功能模块#
• 船舶查询接口:包括船舶模糊搜索、单船位置查询、多船位置查询、区域船舶查询、船队船舶查询、周边船舶查询、船舶档案查询和船舶船籍查询等功能。开发者可以通过多种参数查询船舶的静态和动态信息。• 港口查询接口:包括港口信息查询、港口当前靠泊船查询、港口当前到锚船查询、港口预抵船舶查询等功能。开发者可以通过通过港口信息查询获取港口五位码等信息,再通过港口五位码查询港口预抵、靠泊、到锚的船舶列表清单。• 历史行为接口:历史轨迹查询通过船舶的MMSI查询船舶过去某段时间的轨迹数据,提供船舶在特定时间段内的移动轨迹,包括时间、位置、航向等AIS关键信息。船舶搭靠记录查询通过船舶MMSI查询船舶历史搭靠行为记录。• 挂靠记录接口:查询船舶的历史靠港记录。船舶靠港记录查询、船舶挂靠指定港口、船舶当前挂靠状态查询是以船舶为查询角度,获取船舶当前或者历史靠港的记录。港口挂靠历史船舶是以港口为查询角度,获取指定港口历史靠港的船舶列表。• 航线规划接口:提供精确ETA查询和航线规划(港到港、点到点)功能。开发者可以查询船舶的预计到达时间(ETA)和规划航线。• 气象天气接口:提供单点气象、海区天气、港口潮汐、台风数据等功能。开发者可以获取单个坐标的海洋气象、全球主要海区气象综合数据、港口观测站潮汐情况、台风路径等信息。• 海事数据接口:提供全国航行警告记录查询,查看中国海事局发布的中国沿海范围航行警告详细信息和位置信息。• 海图应用接口:提供船位光栅图片和港口位置瓦片等功能。开发者可以在海图上加载应用全球船舶位置大数据以及港口标记。• 船舶推送服务:包括船舶到离事件推送、实时船位信息推送、动态ETA推送、区域提醒推送、AIS事件推送和船舶搭靠事件推送。根据用户设置的船舶列表,船讯网可以主动向用户推送船舶的动态信息。4.使用限制#
• 授权码:开发者需要申请API key(授权码)才能使用接口服务。• 数据量限制:部分接口对查询的数据量有限制,例如多船查询上限为100条,区域船舶查询建议每次请求的区域范围控制在0.5°*0.5°以内。• 频率限制:接口单位时间内请求频率有限制,避免对服务器造成过大压力。5.版本更新#
新增:船舶船籍查询、港口信息查询、港口当前靠泊船查询、港口当前到锚船查询、港口预抵船舶查询、船队/船舶/订阅管理API、船舶搭靠记录查询、航行警告查询、AIS信号消失事件推送新增:接口文档板块、常见问题板块、用户控制台增加用户即将到期提醒/访问超限提醒、每日访问趋势展示优化:变更注册账号方式为用户手机号注册,自行创建key, 权限管理依旧在后台配置。修改:订阅船队方式变更:支持不同的订阅服务下,有不同的船队列表。 6.联系方式#
开发者在使用过程中如有疑问,可以通过以下方式联系船讯网:7.注意事项#
• 数据更新:定期检查接口的版本更新记录,确保使用最新的接口功能。通过以上概述说明,开发者可以快速了解船讯网API接口服务的整体功能、使用方法和限制条件,从而更好地将船讯网的服务集成到自己的应用中。修改于 2026-06-05 07:12:05