开发 出行解决方案参考手册 服务端相关服务 行程前 接驾路径规划

接驾路径规划 最后更新时间: 2020年12月15日

法律声明

版权所有©2019,高德集团。保留一切权利。本文档包含的所有内容除特别声明之外,版权均属于高德集团所有,受《中华人民共和国著作权法》及相关法律法规和中国加入的所有知识产权方面的国际条约的保护。未经本公司书面许可,任何单位和个人不得以任何方式(电子或机械,包括影印)翻印或转载本文档的任何部分,否则将视为侵权,高德集团保留依法追究其法律责任的权利。高德地图API 的一切有关权利属于高德集团所有。本文档并不代表供应商或其代理的承诺,高德集团可在不作任何申明的情况下对本文档内容进行修改。本文档中所涉及的软件产品及其后续升级产品均由高德集团制作并负责全权销售。本文档中提到的其它公司及其产品的商标所有权属于该商标的所有者。

高德地图API 欢迎用户的任何建议或意见。

概述

针对网约车行业的接驾场景提供专业的路径规划服务.

编码格式

如无特殊声明,所有接口的输入参数和输出数据编码全部统一为UTF-8.

服务协议

POST

接口信息

接驾场景

URL

http://tsapi.amap.com/v1/route/pickup?key=#

请求参数

 名称 

 参数 

 字段类型 

 说明 

是否必填 

 key 

 key 

 string 

 开发者key 

 vehicleID 

 车辆ID 

 string 

 车辆唯一标识,允许使用数字、字母、英文中横线(不支持下划线),如"BJ-888888" 

 start 

 起点经纬度 

 jsonArray 

 传入5个轨迹点,轨迹点间隔为3~5s,如

[{"location":"116.471670,39.908278","locateTime":"1546842009556","speed":"0.0","direction":"90.48","height":"0.0","accuracy":"1.0"},{"location":"116.470504,39.908281","locateTime":"1546842004556","speed":"0.0","direction":"90.0","height":"0.0","accuracy":"1.0"},{"location":"116.477669,39.902062","locateTime":"1546841753990","speed":"0.0","direction":"180.99","height":"0.0","accuracy":"1.0"}]

 -location 

 坐标点 

 string 

 116.471670,39.908278 

 -locateTime

时间戳

13位数值,Unix秒时间戳 

 Unix时间 


 -direction 

 方向 

 double 

 以正北为0°,顺时针递增,可选范围为[0-360) 

 -accuracy 

 精度 

 double 

 保留小数点后3位 

 -speed 

 速度 

 double 

 单位 km/h,保留小数点后3位 

 -height 

 高度 

 double 

 单位 m,保留小数点后3位 

 end 

 终点经纬度 

 string 


示例:

/v1/route/pickup?key=8248e5ccc8514b651e4a3706a023ce6b
start:[{"location":"116.359365,39.932324","locateTime":"1546842009556","speed":"0.0","direction":"90.48","height":"0.0","accuracy":"1.0"},{"location":"116.359655,39.932307","locateTime":"1546842004556","speed":"0.0","direction":"90.0","height":"0.0","accuracy":"1.0"},{"location":"116.360202,39.932307","locateTime":"1546841753990","speed":"0.0","direction":"90","height":"0.0","accuracy":"1.0"},{"location":"116.360202,39.932307","locateTime":"1546841753990","speed":"0.0","direction":"90","height":"0.0","accuracy":"1.0"},{"location":"116.362219,39.93234","locateTime":"1546841753990","speed":"0.0","direction":"90","height":"0.0","accuracy":"1.0"}]
end:116.43436,39.931123
vehicleID:12


返回结果

 名称 

 含义

 字段类型 

 说明 

 errcode 

 返回结果状态码 



 errdetail 

 返回结果描述 



 errmsg 

 返回结果状态码描述 



 data 




 -costTime 

 时间 

 int 

 预估时间,单位秒 

 -distance 

 距离 

 int 

 预估距离,单位米 

 -points 

 路径轨迹 



示例:

{     
"data": {         
"costTime": 1098,         
"distance": 12494,         
"points": "116.362221,39.932323;116.36274,39.932323;116.364738,39.932323;116.364754,39.932457;116.363586,39.932453;116.362701,39.932438;116.360535,39.93243;116.359604,39.93243;116.359131,39.93243;116.358299,39.932449;116.357689,39.932457;116.357689,39.932457;116.357536,39.93256;116.356079,39.932564;116.356079,39.932564;116.356056,39.933037;116.356026,39.933815;116.355988,39.934574;116.355972,39.935299;116.355972,39.935505;116.355972,39.935902;116.355988,39.936378;116.355965,39.936474;116.355965,39.936474;116.355766,39.936775;116.355721,39.937687;116.355682,39.938175;116.355606,39.939938;116.355568,39.941837;116.355568,39.941837;116.355621,39.942184;116.355698,39.942467;116.355782,39.942642;116.355896,39.942837;116.35611,39.943146;116.356285,39.943382;116.356415,39.94352;116.356651,39.943726;116.356934,39.943905;116.357239,39.944027;116.357635,39.94416;116.358284,39.944317;116.358803,39.944473;116.359146,39.944576;116.360138,39.944866;116.360687,39.945023;116.361649,39.945278;116.36338,39.945766;116.363976,39.945934;116.364967,39.946217;116.365181,39.946289;116.365402,39.946362;116.365799,39.946522;116.36689,39.946987;116.367188,39.947113;116.367798,39.947365;116.36869,39.947739;116.369476,39.948021;116.369881,39.948139;116.370201,39.948231;116.37085,39.948391;116.371704,39.948524;116.37204,39.948555;116.374031,39.948689;116.374863,39.94875;116.375931,39.948769;116.37748,39.948799;116.37825,39.948807;116.37941,39.948803;116.381233,39.948822;116.382187,39.94883;116.382523,39.94883;116.382729,39.94883;116.383591,39.948841;116.384979,39.948849;116.387489,39.948868;116.38916,39.948891;116.389687,39.948895;116.391533,39.94891;116.39257,39.94891;116.394028,39.94891;116.394615,39.948906;116.395157,39.948906;116.398125,39.948933;116.400711,39.948978;116.401978,39.948997;116.403244,39.949005;116.404289,39.949009;116.404984,39.94902;116.406021,39.949024;116.410522,39.949055;116.411125,39.949081;116.411667,39.949093;116.412605,39.949116;116.413193,39.949142;116.414169,39.949184;116.415611,39.949257;116.41861,39.949341;116.419357,39.949352;116.420021,39.949368;116.420639,39.949387;116.421677,39.949429;116.423004,39.949482;116.425629,39.949593;116.427498,39.949635;116.428169,39.949638;116.428734,39.94965;116.43042,39.949703;"
},   
"errcode": 10000,    
"errdetail": null,     
"errmsg": "OK" }



附录

errcode/errmsg 对照表

 序号 

 errcode 

 errmsg 

 状态描述 

 问题排查策略 

1

 10000 

 OK 

 请求正常 

 请求正常 

2

 10001 

 INVALID_USER_KEY 

 key不正确或过期 

 发起请求时,传入的key不正确或者过期 

3

 10002 

 SERVICE_NOT_AVAILABL E,Solution URL "http://lbs.a map.com/api/webservice/inf o/" 

 没有权限使用相应 的服 务或者请求 接口的路径 拼写 错误 

 

1.没有权限使用相应的服务,例如:申请了WEB定位功能的key,却使用该key访问逆地理编码功能时,就会返回该错误。反之亦然

2.请求接口的路径拼写错误

4

 10003 

 DAILY_QUERY_OVER_LIMI T,Solution URL "http://lbs.am ap.com/api/webservice/info/" 

 访问已超出日访问 量 

 日访问量超限,被系统自动封停,第二天0:0 0会自动解封

5

 10004 

 ACCESS_TOO_FREQUEN T,Solution URL"http://lbs.am ap.com/api/webservice/info/" 

 单位时间内访问过 于频 繁 

 单位时间内(1分钟)访问量超限,被系统 自 动封停,下一分钟自动解封。 

6

 10005 

 INVALID_USER_IP 

 IP白名单出错,发 送请求的服务器IP 不在IP白名单内 

 在LBS官网控制台设置的IP白名单不正确。 白名单中未添加对应服务器的出口IP。可 到"控制台>配置"中设定IP白名单

7

 10006 

 INVALID_USER_DOMAIN 

 绑定域名无效 

 为Key绑定的域名无效,需要在官网控制台 重 新设置 

8

 10007 

 INVALID_USER_SIGNATURE

 数字签名未通过验 证 

 数字签名未通过。在key控制台中,开启 了"数字签名"功 能,但没有按照指定算法生 成"数字签名

9

 10008 

 INVALID_USER_SCODE 

 MD5安全码未通过 验证 

 需要判定key绑定的SHA1,package是否与sd k包里的一致 

10

 10009 

 USERKEY_PLAT_NOMATCH 

 请求key与绑定平 台不 符 

 请求中使用的key与绑定平台不符,例如: 申 请的是JS A PI的key,却用来调Web服务 接口 

11

 10010 

 IP_QUERY_OVER_LIMIT,So lution URL "http://lbs.amap.c om/api/webservice/info/" 

 IP访问超限 

 未设定IP白名单的开发者使用Key发起请 求, 从单个IP向 服务器发送的请求次数超 出限 制,被系统自动封停

12

 10011 

 NOT_SUPPORT_HTTPS 

 服务不支持https请 求 

 服务不支持https请求,如果需要申请支持, 请提交工单联系我们 

13

 10012 

 INSUFFICIENT_PRIVILEGE S 

 权限不足,服务请 求被 拒绝 

 由于不具备请求该服务的权限,所以服务被 拒绝

14

 

 10013

 USER_KEY_RECYCLED 

 Key被删除 

 Key被删除后无法正常使用 

15

 10014 

 QPS_HAS_EXCEEDED_TH E_LIMIT 

 QPS超限 

 QPS超出限制,超出部分的请求被拒绝。限 流阈值内的请求依旧会正常返回 

16

 

 10015

 GATEWAY_TIMEOUT 

 受单机QPS限流限 制 

 受单机QPS限流限制时出现该问题,建议降 低请求的QPS或在控制台提工单联系我们 

17

 10016 

 SERVER_IS_BUSY 

 服务器负载过高 

 服务器负载过高,请稍后再试 

18

 10017

 RESOURCE_UNAVAILABLE

 所请求的资源不可用

 所请求的资源不可用 

19

 10019

CQPS_HAS_EXCEEDED_THE_LIMIT

 使用的某个服务总QPS超限

 

20

 10020

  CKQPS_HAS_EXCEEDED_THE_LIMIT 

 某个Key使用某个服务接口QPS超出限制

 

21

  10021

  CIQPS_HAS_EXCEEDED_THE_LIMIT

来自于同一IP的访问,使用某个服务QPS超出限制

 

22

 10022

CIKQPS_HAS_EXCEEDED_THE_LIMIT 

某个Key,来自于同一IP的访问,使用某个服务QPS 超出限制

 

23

 10023

  KQPS_HAS_EXCEEDED_THE_LIMIT 

某个KeyQPS超出限制

 

24

 20000 

 INVALID_PARAMS  

请求参数非法  

  请求参数的值没有按照规范要求填写。例如,某参数值域范围为[1,3],开发者误填了"4"  

25

 20001  

 MISSING_REQUIRED_PARAMS  

  缺少必填参数  

  缺少接口中要求的必填参数  

26

 20002  

 ILLEGAL_REQUEST  

  请求协议非法  

 请求协议非法 

27

 20003  

 UNKNOWN_ERROR  

  其他未知错误  

  其他未知错误  

28

20011

 INSUFFICIENT_ABROAD_PRIVILEGES 

查询坐标或规划点(包括起点、终点、途经点)在海 外,但没有海外地图权限


29

20012

 ILLEGAL_CONTENT 

 查询信息存在非法内容


30

20051

TERMINAL_NOT_FOUND 

设备不存在,即查询使用的车辆ID没有通过 data/vehicle上传


31

20052

TRACK_NOT_FOUND 

轨迹不存在,即查询使用的订单ID没有通过 data/vehicle上传


32

20800

 OUT_OF_SERVICE 

规划点(包括起点、终点、途经点)不在中国陆地范 围内


33

20801

 NO_ROADS_NEARBY 

划点(起点、终点、途经点)附近搜不到路


34

20802

ROUTE_FAIL 

路线计算失败,通常是由于道路连通关系导致


35

20803

OVER_DIRECTION_RANGE 

起点终点距离过长


36

300**  

ENGINE_RESPONSE_DATA_ERROR  

服务响应失败 

出现3开头的错误码,建议先检查传入参数是否正确,若无法解决,请详细描述错误复现信息,提工单给我们 

 


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