开发 物流服务API 开发指南 骑行&摩托车服务 摩托车路线规划服务

摩托车路线规划服务 最后更新时间: 2024年12月03日

产品简介

高德摩托车路线规划服务,是基于高德专业的地图数据能力,结合摩托车禁限行信息,实现的路线规划能力。开发者可根据起终点坐标检索符合条件的摩托车路线规划方案,支持一次请求返回多条路线结果、支持传入多个途经点、支持根据不同业务场景设置不同的算路策略等。

请求地址

URL

https://restapi.amap.com/v5/direction/motor?key=<用户key>

请求方式

GET

特别注意:该接口是物流API服务收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

origin

起点经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

originid

起点POI ID

起点为POI时,建议填充此值,可提升路线规划准确性

可选

destinationid

目的地POI ID

目的地为POI时,建议填充此值,可提升路线规划准确性

可选

origintype

起点处道路类型

填入此值可以辅助更精准的起点算路。0:普通道路,1:高架上,2:高架下,3:主路,4:辅路,5:隧道,7:环岛,9:停车场内部。

可选

strategy

驾车算路策略

10、默认

13、高速优先

14、不走高速

19、少收费

10

可选

alternative_route

多备选路线

0:不需要,默认返回一条路线

1:需要,最多可返回三条路线

0

可选

waypoints

途经点

途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。

可选

avoidpolygons

避让区域

区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持100个避让区域。

同时传入避让区域及避让道路,仅支持避让道路;

避让区域不能超过81平方公里,否则避让区域会失效。

可选

avoidroad

避让道路

道路名称,只支持一条避让道路

同时传入避让区域及避让道路,仅支持避让道路;

可选

plate

车牌号码

车牌号,如 京AHA322,用于判断限行相关。

可选

show_fields

返回结果控制

show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则:

1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型;

2、多个字段间采用“,”进行分割;

3、show_fields未设置时,只返回基础信息类内字段;

4、show_fields可选取值:cost(道路收费费用)、tmcs(路况信息)、navi(导航动作指令)、cities(途径城市信息)、polyline(路径坐标点串)

可选

sig

数字签名

请参考数字签名获取和使用方法

可选

output

返回结果格式类型

可选值:JSON

json

可选

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

请求示例

https://restapi.amap.com/v5/direction/motor?key=*****&origin=114.046925,30.348725&destination=114.846925,30.948725

返回结果

参数 

类型 

说明 

status

string

本次API访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅info状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

paths

object

算路方案详情

distance

string

方案距离,单位:米

restriction

string

0 代表限行已规避或未限行,即该路线没有限行路段

1 代表限行无法规避,即该线路有限行路段

steps

object

路线分段

instruction

string

行驶指示

orientation

string

进入道路方向

road_name

string

分段道路名称

step_distance

string

分段距离信息

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

show_fields

string

可选差异化结果返回

cost

object

设置后可返回方案所需时间及费用成本

duration

string

线路耗时,包括方案总耗时及分段step中的耗时

tolls

string

此路线道路收费,单位:元,包括分段信息

toll_distance

string

收费路段里程,单位:米,包括分段信息

toll_road

string

主要收费道路

traffic_lights

string

方案中红绿灯个数,单位:个

tmcs

object

设置后可返回分段路况详情

tmc_status

string

路况信息,包括:未知、畅通、缓行、拥堵、严重拥堵

tmc_distance

string

从当前坐标点开始step中路况相同的距离

tmc_polyline

string

此段路况涉及的道路坐标点串,点间用","分隔

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

cities

object

设置后可返回分段途径城市信息

adcode

string

途径区域编码

citycode

string

途径城市编码

city

string

途径城市名称

districts

object

途径区县

name

string

途径区县名称

adcode

string

途径区县编码

polyline

string

设置后可返回分路段坐标点串;两点间用“,”分隔

返回顶部 示例中心 常见问题 智能客服 公众号
二维码