服务介绍

区域船舶是按照区域范围，一次请求该区域内的所有船舶的AIS数据。可以传多个经纬度坐标绘制您想要的多边形范围区域，单次请求的区域建议在1°*1°范围以内，这样单次请求即可全部返回数据，否则需要通过scode多次请求区域内的船舶数据。json格式下可返回2600条船左右的数据，二进制格式下可返回8000条船左右的数据。如果您想查询的范围比较大，可以自行将区域切分成小的区域再去请求数据，可以使用scode重复获取剩余的船舶。同时船讯网也支持定制化推送，使用TCP/IP、Kafka等推送的方式接入区域船查询，定制推送开通请联系商务。

适用场景

1、海关边检监控区域所有船舶。关注沿海区域或重点关注区域范围的所有船舶，监控船舶名单和船舶行为；

2、港口分析船舶密度。划定港口附近范围，监控所有到范围内的所有船舶信息，筛选不同分类的船舶和船舶目的港数据，查看港口周边船舶分布密度等；

3、物流找船匹配。划定出发仓储所在港口周边范围，筛选所有货运船舶信息和目的港，结合档案查询、船舶历史行为和ETA等数据提取合适做货运的船舶清单。

请求限制

此服务使用前需要在控制台创建您应用的key并联系我们的商务进行权限的开通。购买服务后会设定总的区域查询范围，您每次请求的经纬度坐标都不能超出这个范围，超出后无法返回数据。

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见 https://33iwh234s7.apifox.cn/8961339m0

请求地址

请求地址	请求方式	备注
https://api.shipxy.com/apicall/v3/GetAreaShip	Get	如果船舶超过2小时未上报数据，在区域船查询时不会返回这条船的信息，此时无法判定船舶是否还在这个区域内。可根据客户实际情况定制TCP/IP推送，支持设定区域范围、船舶类型/长度/固定自有船队列表多种筛选方式，可自定义推送频率、信息字段等。

请求调用示例

https://api.shipxy.com/apicall/v3/GetAreaShip?key=1F6D701272402D1E7D8D316CCE519123&region=121.289063,35.424868-122.783203,35.281501-122.167969,33.979809&output=1

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

⚪0成功

application/json

成功返回区域船舶查询结果

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "total": 54,
        "scode": 20,
        "continue": 0,
        "ship_list": [
            {
                "mmsi": 370286000,
                "imo": 9844100,
                "call_sign": "HOLO",
                "ship_name": "SEA VICTORIA",
                "ship_cnname": "",
                "data_source": 0,
                "ship_type": 70,
                "length": 340,
                "width": 62,
                "left": 36,
                "trail": 51,
                "draught": 12.7,
                "dest": "SINGAPORE,SG",
                "destcode": "SGSIN",
                "eta": "2025-05-07 00:00:00",
                "navistat": 0,
                "lat": 34.606657,
                "lng": 121.966072,
                "sog": 12.8,
                "cog": 111.4,
                "hdg": 114,
                "rot": 0,
                "last_time": "2025-04-29 13:23:05",
                "last_time_utc": 1745904185
            },
            {
                "mmsi": 412304788,
                "imo": 0,
                "call_sign": "",
                "ship_name": "SUGANYU04788",
                "ship_cnname": "苏赣渔04788",
                "data_source": 0,
                "ship_type": 30,
                "length": 0,
                "width": 0,
                "left": 0,
                "trail": 0,
                "draught": 0,
                "dest": "",
                "destcode": "",
                "eta": "",
                "navistat": 0,
                "lat": 34.507535,
                "lng": 121.96778,
                "sog": 8.6,
                "cog": 246.9,
                "hdg": 511,
                "rot": 0,
                "last_time": "2025-04-29 12:56:02",
                "last_time_utc": 1745902562
            },
  .........
        ]
    }
}

1.4 区域船舶查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

1.4 区域船舶查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例