Shipxy
    • 概述
    • 注册与创建应用
    • 多语言SDK引入
    • AI大模型接入MCP服务
    • 1 船舶查询
      • 1.1 船舶位置查询
        • 1.1.1 单船位置查询
        • 1.1.2 多船位置查询
        • 1.1.3 船队位置查询
      • 1.2 船舶模糊查询
        GET
      • 1.3 周边船舶查询
        GET
      • 1.4 区域船舶查询
        GET
      • 1.5 船舶船籍查询
        GET
      • 1.6 船舶档案查询
        GET
    • 2 港口查询
      • 2.1 港口信息查询
        GET
      • 2.2 港口当前靠泊船查询
        GET
      • 2.3 港口当前到锚船查询
        GET
      • 2.4 港口预抵船舶查询
        GET
    • 3 历史行为
      • 3.1 船舶历史轨迹查询
        GET
      • 3.2 船舶互相搭靠记录查询
        GET
    • 4 挂靠记录
      • 4.1 船舶历史挂靠记录
        GET
      • 4.2 船舶挂靠指定港口记录
        GET
      • 4.3 船舶当前挂靠信息
        GET
      • 4.4 港口挂靠历史船舶
        GET
    • 5 航线规划
      • 5.1 点到点航线规划
        GET
      • 5.2 港到港航线规划
        GET
      • 5.3 预计到达时间(ETA)查询
        GET
    • 6 天气气象
      • 6.1 新全球气象
        • 6.1.1 实时气象数据
        • 6.1.2 未来气象预报
      • 6.2 全球台风
        • 6.2.1 获取全球台风列表
        • 6.2.2 获取单个台风信息
      • 6.3 国内港口潮汐
        • 6.3.1 查询国内潮汐观测站列表
        • 6.3.2 查询单个观测站潮汐详情
      • 6.4 全球港口潮汐
        • 6.4.1 查询全球潮汐观测站列表
        • 6.4.2 查询单个观测站潮汐详情
      • 6.5 海区气象
        GET
      • 6.6 单点海洋气象
        GET
      • 6.7 历史气象记录
        GET
    • 7 海图应用
      • 7.1 船位光栅瓦片
      • 7.2 港口位置瓦片
    • 8 海事数据
      • 8.1 航行警告查询
    • 9 监控推送
      • 9.1 监控船队管理
        • 9.1.1 创建船队
        • 9.1.2 更新船队信息
        • 9.1.3 查询船队
        • 9.1.4 删除船队
        • 9.1.5 船队船舶增加
        • 9.1.6 船队船舶批量更新
        • 9.1.7 船队船舶删除
      • 9.2 区域监控推送
        • 9.2.1 区域创建
        • 9.2.2 区域更新
        • 9.2.3 区域查询
        • 9.2.4 区域删除
        • 9.2.5 区域监控推送内容
      • 9.3 船舶航速提醒推送
        • 9.3.1 新增船舶订阅
        • 9.3.2 删除订阅船舶信息
        • 9.3.3 查询订阅船舶列表
        • 9.3.4 船舶航速异常推送
      • 9.4 实时船位推送
      • 9.5 船舶到离港事件推送
      • 9.6 船舶动态ETA推送
      • 9.7 船舶AIS信号消失事件推送
      • 9.8 船舶搭靠事件推送
    • 文档附录
      • 船舶类型对照表
      • 服务码返回说明
      • 海区对照表
      • 航行状态对照表
      • 绕航节点清单
      • 航标类型对照表

    概述

    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.版本更新#

    • V3.0:2025年05月16日发布。
    1、API服务
    新增:船舶船籍查询、港口信息查询、港口当前靠泊船查询、港口当前到锚船查询、港口预抵船舶查询、船队/船舶/订阅管理API、船舶搭靠记录查询、航行警告查询、AIS信号消失事件推送
    优化:区域船查询支持全部数据获取。
    2、官网
    新增:接口文档板块、常见问题板块、用户控制台增加用户即将到期提醒/访问超限提醒、每日访问趋势展示
    优化:变更注册账号方式为用户手机号注册,自行创建key, 权限管理依旧在后台配置。
    修改:订阅船队方式变更:支持不同的订阅服务下,有不同的船队列表。

    6.联系方式#

    开发者在使用过程中如有疑问,可以通过以下方式联系船讯网:
    • 商务邮箱:support@shipxy.com
    • 技术支持邮箱:service@shipxy.com
    • 电话:400-010-8558

    7.注意事项#

    • 权限限制:部分接口需要开通特定权限才能使用。
    • 数据更新:定期检查接口的版本更新记录,确保使用最新的接口功能。
    通过以上概述说明,开发者可以快速了解船讯网API接口服务的整体功能、使用方法和限制条件,从而更好地将船讯网的服务集成到自己的应用中。
    修改于 2026-06-05 07:12:05
    下一页
    注册与创建应用
    Built with