飞驼可视船舶定位 API
全球船舶 AIS 实时定位 · ETA 预到时间 · 历史轨迹查询 — 一站式海运数据接口
飞驼可视船舶定位 API 基于全球 AIS（船舶自动识别系统） 数据网络，融合岸基 AIS 与卫星 AIS 双数据源，为企业级用户提供高覆盖率、低延迟的船舶实时位置、航行状态、ETA 预到时间及历史轨迹查询服务。接口采用 RESTful 架构，支持通过 MMSI 号精准查询单船动态，适用于物流供应链可视化、航运风控、港口调度、大宗商品贸易等多种业务场景。
应用场景与价值
船舶定位 API 为海运产业链各环节提供实时、精准的船舶动态数据，帮助企业实现从“被动等待”到“主动预判”的运营升级。
核心应用场景
集装箱物流追踪
通过船舶实时位置与 ETA，精准预判货物到港时间，优化内陆运输衔接与仓储调度，降低滞箱滞港成本。
供应链可视化
为跨境电商、3PL、货代企业提供在途货物可视化能力，提升客户体验与订单履约可预测性。
航运风控与保险
监控船舶航行状态与异常偏离，为海上保险、船舶融资、大宗商品贸易提供风险预警与定损依据。
港口与码头调度
基于 ETA 与实时位置优化泊位计划、引航调度和堆场资源分配，提升港口运营效率与吞吐能力。
大宗商品贸易
跟踪油轮、散货船动态，预判大宗商品到港节奏，辅助贸易决策与库存管理，把握市场窗口期。
海事监管与合规
为海事管理机构、环保组织提供船舶轨迹溯源能力，支持污染监测、非法捕捞排查与航线合规审计。
产品价值
- 降本增效： 精准 ETA 减少滞箱费、滞港费和仓储等待成本，据行业数据可降低 15%-30% 的港口相关费用。
- 数据驱动决策： 实时船舶动态与历史轨迹为航线优化、运力调配提供数据支撑，提升运营决策科学性。
- 客户体验升级： 为终端客户提供货物在途可视化，减少查询沟通成本，提升服务满意度与复购率。
- 风险前置管理： 通过航行状态监控与异常预警，将风险处置从“事后补救”前移至“事前预防”。
- 灵活集成： 标准 RESTful 接口，支持多语言 SDK，可快速嵌入企业自有系统、BI 平台或移动端应用。
业务覆盖范围
飞驼可视船舶 AIS 数据来源于 卫星 AIS 与 岸基 AIS 两大渠道，确保全球海域的连续覆盖。
数据来源与更新频率
| 数据来源 | 更新频率 | 覆盖区域 |
|---|---|---|
| 岸基 AIS | 2 分钟/次 | 沿海港口及近岸海域 |
| 卫星 AIS | 10 分钟/次 | 全球远洋海域 |
船舶覆盖规模
- 全球商用船舶共计 25万+艘 ，数据覆盖率 99.9%
- 集装箱船舶： 7,271艘
- 散货船： 14,109艘
- 滚装船（RORO）： 1,232艘
- 油轮： 8,500艘
船舶类型（shiptype）说明
接口返回的 shipType 字段遵循国际 AIS 标准编码，常见船型如下：
| shiptype | 英文说明 | 中文说明 |
|---|---|---|
| 0 | Not available (default) | 不可用（默认） |
| 30 | Fishing | 渔船 |
| 31 | Towing | 工作船 |
| 35 | Military ops | 军用船舶 |
| 36 | Sailing | 帆船 |
| 40 | High speed craft (HSC) | 高速船 |
| 50 | Pilot Vessel | 引航船 |
| 51 | Search and Rescue vessel | 救助船 |
| 52 | Tug | 拖船 |
| 55 | Law Enforcement | 执法船 |
| 60 | Passenger | 客船 |
| 70 | Cargo | 货船 |
| 80 | Tanker | 油船 |
| 90 | Other Type | 其他 |
航行状态（navStatus）说明
| navStatus | 描述 |
|---|---|
| 0 | 在航（主机推动） |
| 1 | 锚泊 |
| 2 | 失控 |
| 3 | 操纵受限 |
| 4 | 吃水受限 |
| 5 | 靠泊 |
| 6 | 搁浅 |
| 7 | 从事捕鱼 |
| 8 | 靠船帆提供动力 |
| 14 | AIS-SART |
| 15 | 未定义 |
船舶 AIS 定位+ETA（单船查询）
根据 MMSI 号查询当前船舶最新位置和下一港口的 ETA 时间（船长人工录入的 ETA）。
请求参数
Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 在 Header 中添加，值为 Bearer 之后拼接 Token。示例： Authorization: Bearer ******************** |
Query 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
mmsi | string | 是 | MMSI 号（海上移动通信业务标识码） | 235103287 |
请求示例
curl --location 'http://openapi.freightower.com/vessel2/ais/getVesselDetail?mmsi=235103287' \ --header 'Authorization: Bearer <token>'
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 状态码 |
message | string | 提示信息 |
| data 对象 | ||
nameEn | string | 船名（优先中文，无中文显示英文） |
aisName | string | 英文船名 |
shipType | string | 船舶类型（参见 shiptype 说明） |
mmsi | string | MMSI 号 |
imo | string | IMO 号 |
callSign | string | 呼号 |
flagName | string | 船旗 |
length | integer | 船长（单位：分米） |
breadth | integer | 船宽（单位：分米） |
gt | integer/null | 总吨（单位：吨） |
dwt | integer/null | 载重吨（单位：吨） |
navStatus | integer | 船舶航行状态（船长填写，参见 navStatus 说明） |
draught | integer | 吃水（单位：毫米） |
cog | integer | 航迹向（1/100 度，正北为 0） |
hdg | integer/null | 船艏向（1/100 度，正北为 0） |
sog | integer | 航速（单位：毫米/秒） |
dest | string | 目的地（船长填写，一般指下一个港） |
destStd | string | 港口名称（飞驼标准化） |
destcode | string | 港口 CODE（飞驼标准化） |
eta | string | 预到时间（格式：MM-dd HH:mm，当地时间） |
etaStd | string | 预到时间（格式：yyyy-MM-dd HH:mm:ss，当地时间） |
lat | integer | 纬度（1/1000000 度，WGS84 坐标系） |
lon | integer | 经度（1/1000000 度，WGS84 坐标系） |
updateTime | string | 更新时间（北京时间） |
返回示例
{
"statusCode": 20000,
"message": "成功",
"data": {
"length": 1770,
"breadth": 280,
"gt": null,
"dwt": null,
"flagName": "英国",
"callSign": "2HFS4",
"mmsi": "235103287",
"imo": "9343625",
"shipType": "70",
"nameEn": "HA LONG BAY",
"aisName": "HA LONG BAY",
"navStatus": 0,
"updateTime": "2024-03-15 10:16:57",
"draught": 10100,
"cog": 10900,
"hdg": null,
"sog": 7202,
"dest": "EG PST",
"destStd": "",
"destcode": "",
"eta": "03-18 21:00",
"etaStd": "2024-03-18 21:00:00",
"lat": 37633333,
"lon": 9598333
}
}船舶历史轨迹查询
根据 MMSI 号和时间范围查询船舶历史航行轨迹。最多支持近 180 天 的轨迹，每个时间段只能查询 90 天 。
请求参数
Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | Bearer Token，格式同单船定位接口 |
Query 参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
mmsi | string | 是 | MMSI 号 | 565747000 |
startTime | string | 是 | 开始时间，格式：yyyy-MM-dd HH:mm:ss | 2025-07-01 00:00:00 |
endTime | string | 是 | 结束时间，格式：yyyy-MM-dd HH:mm:ss | 2025-07-04 00:00:00 |
请求示例
curl --location 'http://openapi.freightower.com/vessel2/ais/getVesselVoyage?mmsi=565747000&startTime=2025-07-01%2000%3A00%3A00&endTime=2025-07-04%2000%3A00%3A00' \ --header 'Authorization: Bearer <token>'
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
statusCode | integer | 状态码 |
message | string | 提示信息 |
| data 数组（轨迹点列表） | ||
course | integer | 航迹向（1/100 度） |
lat | integer | 纬度（1/1000000 度，除完后为 WGS84） |
lon | integer | 经度（1/1000000 度，除完后为 WGS84） |
posTime | string | 发生时间（北京时间） |
speed | integer | 速度（单位：毫米/秒） |
返回示例
{
"statusCode": 20000,
"message": "成功",
"data": [
{
"course": 33200,
"lat": 36005745,
"lon": 120203641,
"posTime": "2023-12-03 07:48:33",
"speed": 0
},
{
"course": 110,
"lat": 36006188,
"lon": 120203913,
"posTime": "2023-12-03 16:03:32",
"speed": 0
}
]
}FAQ
常见问题
飞驼可视船舶定位API支持哪些船型？
支持全球商用船舶共计25万+艘，数据覆盖率99.9%，涵盖集装箱船7,271艘、散货船14,109艘、滚装船1,232艘、油轮8,500艘等全船型，具体可参考shiptype编码表。
AIS数据的更新频率是多少？
岸基AIS数据更新频率为2分钟/次，主要覆盖沿海港口及近岸海域；卫星AIS数据更新频率为10分钟/次，覆盖全球远洋海域。两者结合确保全球海域的连续数据覆盖。
历史轨迹最多可以查询多长时间？
最多支持近180天的轨迹查询，但每个请求的时间区间不能超过90天。如需查询更长时间段，请将区间拆分后分别调用。
如何获取API调用的Token？
请联系飞驼可视商务团队开通API服务，开通后将获得专属Bearer Token，用于所有接口的身份鉴权。Token需在请求Header的Authorization字段中携带。
经纬度坐标是什么坐标系？
接口返回的经纬度为WGS84坐标系（GPS标准坐标系），原始值为整数，需除以1,000,000转换为十进制度数。例如 lat=37633333 对应纬度 37.633333°。
接口有调用频率限制吗？
接口调用频率根据您的服务套餐而定。建议合理控制请求频率，对于批量船舶监控场景，可采用轮询策略并结合缓存机制以降低调用次数。具体配额请咨询商务团队。
