路径规划 2.0 |
您所在的位置:网站首页 › 高德地图更新路线 › 路径规划 2.0 |
产品概述 路线规划接口2.0是一类Web API接口服务,以HTTP/HTTPS形式提供了多种路线规划服务。支持驾车、公交、步行、骑行、电动车路线规划。 功能介绍驾车路线规划: 开发者可根据起终点坐标检索符合条件的驾车路线规划方案,支持一次请求返回多条路线结果、支持传入多个途经点、支持传入车牌规避限行、支持根据不同业务场景设置不同的算路策略等。 步行路线规划: 开发者可根据起终点坐标检索符合条件的步行路线规划方案。 公交路线规划: 开发者可根据起终点坐标检索符合条件的公共交通路线规划方案,支持结合业务场景设置不同的公交换乘策略。 骑行路线规划: 开发者可根据起终点坐标检索符合条件的骑行路线规划方案。 电动车路线规划: 开发者可根据起终点坐标检索符合条件的电动车路线规划方案,与骑行略有不同的是会考虑限行等条件。 流量限制目前该服务是试用阶段,如果您有正式上线需求,请随时通过工单跟我们沟通配额流量问题。 使用说明第一步,申请Web服务API类型Key; 第二步,参考接口参数文档发起HTTP/HTTPS请求,第一步申请的 Key 需作为必填参数一同发送; 第三步,解析请求返回的数据(JSON格式),参考返回参数文档解析数据。 如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。 服务文档驾车路线规划驾车路线规划 API 服务地址URL https://restapi.amap.com/v5/direction/driving?parameters 请求方式 GET,当参数过长导致请求失败时,需要使用POST方式请求。 请求参数参数名 含义 规则说明 是否必须 缺省值 key 高德Key 用户在高德地图官网申请Web服务API类型Key 必填 无 origin 起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 destination 目的地 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 origin_id 起点POI ID 起点为POI时,建议填充此值,可提升路线规划准确性 可选 无 destination_id 目的地POI ID 目的地为POI时,建议填充此值,可提升路线规划准确性 可选 无 origin_type 起点处道路类型 填入此值可以辅助更精准的起点算路 0:普通道路 1:高架上 2:高架下 3:主路 4:辅路 5:隧道 7:环岛 9:停车场内部 可选 无 strategy 驾车算路策略 0:速度优先(只返回一条路线),此路线不一定距离最短 1:费用优先(只返回一条路线),不走收费路段,且耗时最少的路线 2:距离优先(只返回一条路线),仅走距离最短的路线,但是可能存在穿越小路/小区的情况 3:速度优先(只返回一条路线),不走快速路,例如京通快速路 32:默认,高德推荐,同高德地图APP默认 33:躲避拥堵 34:高速优先 35:不走高速 36:少收费 37:大路优先 38:速度最快 39:躲避拥堵+高速优先 40:躲避拥堵+不走高速 41:躲避拥堵+少收费 42:少收费+不走高速 43:躲避拥堵+少收费+不走高速 44:躲避拥堵+大路优先 45:躲避拥堵+速度最快 可选 32 waypoints 途经点 途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。 可选 无 avoidpolygons 避让区域 区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持32个避让区域。 同时传入避让区域及避让道路,仅支持避让道路; 每个避让区域不能超过81平方公里,否则避让区域会失效。 可选 无 avoidroad 避让道路名 只支持一条避让道路 可选 无 plate 车牌号码 车牌号,如 京AHA322,支持6位传统车牌和7位新能源车牌,用于判断限行相关。 可选 无 cartype 车辆类型 0:普通燃油汽车 1:纯电动汽车 2:插电式混动汽车 可选 0 ferry 是否使用轮渡 0:使用渡轮 1:不使用渡轮 可选 0 show_fields 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段; 可选 空 sig 数字签名 请参考数字签名获取和使用方法 可选 无 output 返回结果格式类型 可选值:JSON 可选 json callback 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 可选 无 返回结果名称 类型 说明 status string 本次API访问状态,如果成功返回1,如果失败返回0。 info string 访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明。 infocode string 返回状态说明,10000代表正确,详情参阅info状态表 count string 路径规划方案总数 route object 返回的规划方案列表 origin string 起点经纬度 destination string 终点经纬度 taxi_cost 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 途径城市名称 district object 途径区县信息 name string 途径区县名称 adcode string 途径区县adcode polyline string 设置后可返回分路段坐标点串,两点间用“,”分隔 步行路线规划步行路线规划 API 服务地址URL https://restapi.amap.com/v5/direction/walking?parameters 请求方式 GET 请求参数参数名 含义 规则说明 是否必须 缺省值 key 高德Key 用户在高德地图官网申请Web服务API类型Key 必填 无 origin 起点信息 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 destination 目的地信息 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 alternative_route 返回路线条数 1:多备选路线中第一条路线 2:多备选路线中前两条路线 3:多备选路线中三条路线 不传则默认返回一条路线方案 可选 空 show_fields 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段。 可选 空 sig 数字签名 请参考数字签名获取和使用方法 可选 无 output 返回结果格式类型 可选值:JSON 可选 json callback 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 可选 无 返回结果名称 类型 说明 status string 本次API访问状态,如果成功返回1,如果失败返回0。 info string 访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明。 infocode string 返回状态说明,10000代表正确,详情参阅info状态表 count string 路径规划方案总数 route object 返回的规划方案列表 origin string 起点经纬度 destination string 终点经纬度 paths object 算路方案详情 distance string 方案距离,单位:米 steps object 路线分段 instruction string 步行指示 orientation string 进入道路方向 road_name string 分段道路名称 step_distance string 分段距离信息 注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。 cost object 设置后可返回方案所需时间及费用成本。注意:steps中不返回taxi字段。 duration string 线路耗时,包括方案总耗时及分段step中的耗时 taxi string 预估打车费用 navi object 设置后可返回详细导航动作指令 action string 导航主要动作指令 assistant_action string 导航辅助动作指令 walk_type string 算路结果中存在的道路类型: 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡 polyline string 设置后可返回分路段坐标点串,两点间用“,”分隔 骑行路线规划 骑行路线规划 API 服务地址URL https://restapi.amap.com/v5/direction/bicycling?parameters 请求方式 GET 请求参数参数名 含义 规则说明 是否必须 缺省值 key 高德Key 用户在高德地图官网申请Web服务API类型Key 必填 无 origin 起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 destination 目的地 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 show_fields 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段。 可选 空 alternative_route 返回方案条数 1:多备选路线中第一条路线 2:多备选路线中前两条路线 3:多备选路线中三条路线 不传则默认返回一条路线方案 可选 空 sig 数字签名 请参考数字签名获取和使用方法 可选 无 output 返回结果格式类型 可选值:JSON 可选 json callback 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 可选 无 返回结果名称 类型 说明 status string 本次API访问状态,如果成功返回1,如果失败返回0。 info string 访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明。 infocode string 返回状态说明,10000代表正确,详情参阅info状态表 count string 路径规划方案总数 route object 返回的规划方案列表 origin string 起点经纬度 destination string 终点经纬度 paths object 算路方案详情 distance string 方案距离,单位:米 steps object 路线分段 instruction string 骑行指示 orientation string 进入道路方向 road_name string 分段道路名称 step_distance string 分段距离信息 注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。 cost object 设置后可返回方案所需时间及费用成本 duration string 线路耗时,包括方案总耗时及分段step中的耗时 navi object 设置后可返回详细导航动作指令 action string 导航主要动作指令 assistant_action string 导航辅助动作指令 walk_type string 算路结果中存在的道路类型: 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡 polyline string 设置后可返回分路段坐标点串,两点间用“,”分隔 电动车路线规划 电动车(骑行)路线规划 API 服务地址URL https://restapi.amap.com/v5/direction/electrobike?parameters 请求方式 GET 请求参数参数名 含义 规则说明 是否必须 缺省值 key 高德Key 用户在高德地图官网申请Web服务API类型Key 必填 无 origin 起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 destination 目的地 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 show_fields 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段。 可选 空 alternative_route 返回方案条数 1:多备选路线中第一条路线 2:多备选路线中前两条路线 3:多备选路线中三条路线 不传则默认返回一条路线方案 可选 空 sig 数字签名 请参考数字签名获取和使用方法 可选 无 output 返回结果格式类型 可选值:JSON 可选 json callback 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 可选 无 返回结果名称 类型 说明 status string 本次API访问状态,如果成功返回1,如果失败返回0。 info string 访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明。 infocode string 返回状态说明,10000代表正确,详情参阅info状态表 count string 路径规划方案总数 route object 返回的规划方案列表 origin string 起点经纬度 destination string 终点经纬度 paths object 算路方案详情 distance string 方案距离,单位:米 steps object 路线分段 instruction string 骑行指示 orientation string 进入道路方向 road_name string 分段道路名称 step_distance string 分段距离信息 注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。 cost object 设置后可返回方案所需时间及费用成本 duration string 线路耗时,包括方案总耗时及分段step中的耗时 navi object 设置后可返回详细导航动作指令 action string 导航主要动作指令 assistant_action string 导航辅助动作指令 walk_type string 算路结果中存在的道路类型: 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡 polyline string 设置后可返回分路段坐标点串,两点间用“,”分隔 公交路线规划公交路线规划 API 服务地址URL https://restapi.amap.com/v5/direction/transit/integrated?parameters 请求方式 GET 请求参数参数名 含义 规则说明 是否必须 缺省值 key 高德Key 用户在高德地图官网申请Web服务API类型Key 必填 无 origin 起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 destination 目的地经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 必填 无 originpoi 起点POI ID 1、起点POI ID与起点经纬度均填写时,服务使用起点 POI ID; 2、该字段必须和目的地 POI ID 成组使用。 可选 无 destinationpoi 目的地POI ID 1、目的地POI ID与目的地经纬度均填写时,服务使用目的地 POI ID; 2、该字段必须和起点 POI ID 成组使用。 可选 无 ad1 起点所在行政区域编码 仅支持adcode,参考行政区域编码表 可选 无 ad2 终点所在行政区域编码 仅支持adcode,参考行政区域编码表 可选 无 city1 起点所在城市 仅支持citycode,相同时代表同城,不同时代表跨城 必填 无 city2 目的地所在城市 strategy 公共交通换乘策略 可选值: 0:推荐模式,综合权重,同高德APP默认 1:最经济模式,票价最低 2:最少换乘模式,换乘次数少 3:最少步行模式,尽可能减少步行距离 4:最舒适模式,尽可能乘坐空调车 5:不乘地铁模式,不乘坐地铁路线 6:地铁图模式,起终点都是地铁站 (地铁图模式下originpoi及destinationpoi为必填项) 7:地铁优先模式,步行距离不超过4KM 8:时间短模式,方案花费总时间最少 可选 0 AlternativeRoute 返回方案条数 可传入1-10的阿拉伯数字,代表返回的不同条数。 可选 5 multiexport 地铁出入口数量 0:只返回一个地铁出入口 1:返回全部地铁出入口 可选 0 max_trans 最大换乘次数 0:直达 1:最多换乘1次 2:最多换乘2次 3:最多换乘3次 4:最多换乘4次 可选 4 nightflag 考虑夜班车 可选值: 0:不考虑夜班车 1:考虑夜班车 可选 0 date 请求日期 例如:2013-10-28 可选 空 time 请求时间 例如:9-54 可选 空 show_fields 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段。 可选 空 sig 数字签名 请参考数字签名获取和使用方法 可选 无 output 返回结果格式类型 可选值:JSON 可选 json callback 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 可选 无 返回结果名称 类型 说明 status string 本次API访问状态,如果成功返回1,如果失败返回0。 info string 访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明。 infocode string 返回状态说明,10000代表正确,详情参阅info状态表 count string 路径规划方案总数 route object 返回的规划方案列表 origin string 起点经纬度 destination string 终点经纬度 transits object 公交方案列表 distance string 本条路线的总距离,单位:米 nightflag nightflag 0:非夜班车;1:夜班车 segments object 路线分段 walking string 此分段中需要步行导航的信息 steps 参考v3老接口 bus string 此分段中需要公交导航的信息 steps 参考v3老接口 railway string 此分段中需要火车的信息 steps 参考v3老接口 taxi price string 打车预计花费金额 drivetime string 打车预计花费时间 distance string 打车距离 polyline string 线路点集合,通过show_fields控制返回与否 startpoint string 打车起点经纬度 startname string 打车起点名称 endpoint string 打车终点经纬度 endname string 打车终点名称 注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。 cost object 设置后可返回方案所需时间及费用成本注意:taxi_cost只在route中返回,transit_fee只在segments下返回。分段steps下不返回cost。 duration string 线路耗时,方案总耗时,包含等车时间 taxi_cost string 预估出租车费用 transit_fee string 各换乘方案总花费 navi object 设置后可返回详细导航动作指令 action string 导航主要动作指令 assistant_action string 导航辅助动作指令 walk_type string 算路结果中存在的道路类型: 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡 polyline string 设置后可返回分路段坐标点串,两点间用“,”分隔 错误码说明:https://developer.amap.com/api/webservice/guide/tools/info |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |