开发 出行解决方案参考手册 服务端相关服务 行程中 订单路线绑定

订单路线绑定 最后更新时间: 2020年12月15日

法律声明

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

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

概述

针对网约车行业的估价提供专业的路径规划服务

编码格式

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

服务协议

POST

接口信息

估价及导航路径规划场景使用

URL

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


请求参数

名称

含义

字段类型

说明

是否必填

orderID

合作方平台自己的订单ID

string

大小写字母,数字,中划线,下划线

routeID

订单选定的routeID

string

服务下发

strategyType

策略类型

int

输入“1”严格按照预估路线行驶

输入“2”按照价格最优路线行驶

返回结果

SUCCESS,失败SDK重试


结果示例

{
    "data": null,
    "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开头的错误码,建议先检查传入参数是否正确,若无法解决,请详细描述错误复现信息,提工单给我们 


客户支持

如果您在使用高德地图API产品时遇到问题,请先参考提供的相关资料。如仍未解决,请与我们联系。您可以通过下列途径获得满意答复: 在线支持:http://lbs.amap.com/

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