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接口服务的整体功能、使用方法和限制条件，从而更好地将船讯网的服务集成到自己的应用中。