服务介绍

查询两个坐标点或者从起始点到终点港之间的航线规划，获取航线的总里程以及航线经过的点位坐标经纬度。

适用场景

1、物流跟踪。规划好固定航线记录在根据船舶的实时位置做匹配，监控船舶是否按照既定的航线行驶，可以通过计算点位与路径的距离做偏航预警。也可以通过历史轨迹追踪与规划的航线做展示效果，比对船舶运输的航次真实轨迹与规划的路径的差异。

2、导航指引。船舶行进过程中，根据当前位置点和目的港口，及时获取建议的行进航线，可搭配气象等数据进行恶劣天气避让，或者海图中绘制未来行进航线模拟。

请求限制

此服务使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。

在线调试

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

请求地址

请求地址	请求方式
https://api.shipxy.com/apicall/v3/PlanRouteByPoint	Get

请求调用示例

https://api.shipxy.com/apicall/v3/PlanRouteByPoint?key=1F6D701272402D1E7D8D316CCE519123&start_point=113.571144,22.844316&end_point=121.58414,31.37979

https://api.shipxy.com/apicall/v3/PlanRouteByPoint?key=1F6D701272402D1E7D8D316CCE519123&start_point=113.571144,22.844316&end_port_code=CNQDG

**注：**例子中的 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": {
        "distance": 915.22,
        "route": [
            {
                "lng": 113.571144,
                "lat": 22.844316
            },
            {
                "lng": 113.56867,
                "lat": 22.82417
            },
            {
                "lng": 113.59017,
                "lat": 22.81067
            },
            {
                "lng": 121.58414,
                "lat": 31.37979
            }
        ]
    }
}

5.1 点到点航线规划

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

5.1 点到点航线规划

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例