产品简介
高德摩托车路线规划服务,是基于高德专业的地图数据能力,结合摩托车禁限行信息,实现的路线规划能力。开发者可根据起终点坐标检索符合条件的摩托车路线规划方案,支持一次请求返回多条路线结果、支持传入多个途经点、支持根据不同业务场景设置不同的算路策略等。
请求地址
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 | 设置后可返回分路段坐标点串;两点间用“,”分隔 |