估价路径规划 最后更新时间: 2020年12月15日
法律声明
版权所有©2019,高德集团。保留一切权利。本文档包含的所有内容除特别声明之外,版权均属于高德集团所有,受《中华人民共和国著作权法》及相关法律法规和中国加入的所有知识产权方面的国际条约的保护。未经本公司书面许可,任何单位和个人不得以任何方式(电子或机械,包括影印)翻印或转载本文档的任何部分,否则将视为侵权,高德集团保留依法追究其法律责任的权利。高德地图API 的一切有关权利属于高德集团所有。本文档并不代表供应商或其代理的承诺,高德集团可在不作任何申明的情况下对本文档内容进行修改。本文档中所涉及的软件产品及其后续升级产品均由高德集团制作并负责全权销售。本文档中提到的其它公司及其产品的商标所有权属于该商标的所有者。
高德地图API 欢迎用户的任何建议或意见。
概述
针对网约车行业的估价提供专业的路径规划服务.
编码格式
如无特殊声明,所有接口的输入参数和输出数据编码全部统一为UTF-8.
服务协议
POST
接口信息
估价场景使用
URL
https://tsapi.amap.com/v1/route/price?key=#
请求参数
名称 | 含义 | 字段类型 | 说明 | 是否必填 |
---|---|---|---|---|
key | key | string | 开发者key | 是 |
customerDeviceID | 设备号 | string | 下单用户设备号 Android系统: IMEI 例: 862918039347887 iOS系统: IDFA (无IDFA则使用IDFV) | 是 |
extensions | 返回信息 | string | 全部返回:“all” 部分返回:“base” | 是 |
start | 起点经纬度 | string | 1.经度在前,纬度在后,经度和纬度用英文半角逗 号","分隔; 2.单次只可以传入一组经纬度坐标对。 如: 116.473195,39.993253 | 是 |
end | 终点经纬度 | string | 同start | 是 |
startID | 起点POIID | string | 建议填写,可以更精准计算ETA | 否 |
endID | 终点POIID | string | 建议填写,可以更精准计算ETA | 否 |
departureTime | 订单出发时间 | 10位数 值,Uni x秒时间 戳 | 1.现在(即实时单),不传此参数,2.具体时间(预约 单),u nix秒时间戳格式 实时订单将根据实时路况进行路径规划,预约单将根据 未来路 况进行路径规划,最长不超 过7天(从当前时刻 算起,168个小 时),对于超过7天的时间返回报错 | 是 |
startType | 起点类型参数 | string | 输入“1”推荐上车点 输入“2”地图扎针 输入“3”搜索 当参数设置的值为3时,则在请求引擎算路时,起点传入对应的POIID,1或2时,则不传。 | 否 |
strategyType | 订单路线绑定接口 | string | 输入“1”严格按照估价路线行驶 输入“2”按照价格最优路线行驶 | 否 |
priceParam | 定价规则 | json | jsonObject,有以下字段 起步费:flagDownFare 起步里程:flagDownDistance 起步时长:flagDownDuration 基础费:baseFare 长途费起步距离:ldFlagDownDistance 长途费单价:ldUnitPrice 低速费单价:lowSpeedUnitPrice 低速值:lowSpeed 里程分段计价: distanceSection:[ {"start": "20:00:00","end": "20:10:00","unitPrice":12.21}, {"start": "20:30:00","end": "21:30:00","unitPrice":22.21} ] 时间分段计价: timeSection:[ {"start": "19:00:00","end": "20:10:00","unitPrice":12.21}, {"start": "20:30:00","end": "21:30:00","unitPrice":22.21 }] 单价、费用都是支持两位小数的正数,时长为正整数 字段依赖逻辑: 1.起步费用与基础费用至少传一个字段,如果两个均未传,则按照基础费为0进行处理,当两个都传入时,则按照基础价进行计费,即不再考虑起步价逻辑,则进行参数报错 2.当传入起步费时,须一同传入起步里程和起步时长 3.长途费起步距离和长途费单价须同时传入,不可只传一个 4.低速费与低速费单价须同时传入,不可只传一个 5.里程、时间分段计价若时间段未能做到全覆盖,则未传入时间段的单价按照0处理 | 否 |
timeSections | 分段计价区间 | jsonArrayString | 可以最大传10个组,每组最多24个区间,样式如下 [ { "name": "group1", "sections": [ { "start": "01:00:00", "end": "01:30:00" }, { "start": "02:00:00", "end": "02:30:00" } ] }, { "name": "group2", "sections": [ { "start": "03:00:00", "end": "03:30:00" }, { "start": "04:00:00", "end": "04:30:00" } ] } ] | 否 |
示例:
curl -X POST \
'http://127.0.0.1:8082/v1/route/price?key=8248e5ccc8514b651e4a3706a023ce6b' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Postman-Token: bca75659-47b3-4c3c-8866-7b7d69ed6bae' \
-H 'cache-control: no-cache' \
-d 'start=116.358083%2C39.907084&end=116.634591%2C38.908507&priceParam=%7B%22distanceSection%22%3A%5B%7B%22end%22%3A%2220%3A17%3A15%22%2C%22start%22%3A%2208%3A47%3A15%22%2C%22unitPrice%22%3A2.5%7D%5D%2C%22timeSection%22%3A%5B%7B%22end%22%3A%2220%3A17%3A15%22%2C%22start%22%3A%2208%3A47%3A15%22%2C%22unitPrice%22%3A2.5%7D%5D%2C%22flagDownDistance%22%3A3.0%2C%22flagDownDuration%22%3A10%2C%22flagDownFare%22%3A10.0%7D&customerDeviceID=123&extensions=base'
返回结果
名称 | 含义 | 字段类型 | 说明 |
---|---|---|---|
errcode | 返回结果状态码 | ||
errdetail | 返回结果描述 | ||
errmsg | 返回结果状态码描述 | ||
data | 路径信息 | ||
-routeID | 路线唯一ID | string | priceParam不为空时存在 |
-count | 路径规划数量 | int | 返回结果包含的路径数量 |
-path | |||
--costTime | 时间 | int | 预估时间,单位秒 |
--distance | 距离 | int | 预估距离,单位米 |
--tolls | 道路收费 | int | 单位:元 |
--points | 路径轨迹 | string | 返回信息为“all”时返回 |
示例:
{
"data": {
"count": 3,
"paths": [
{
"costTime": 1740,
"distance": 6996,
"points": "116.362743,39.932109;116.362743,39.93224;116.362743,39.932322;116.36474,39.932322;116.367188,39.932331;116.367947,39.932335;116.368064,39.932339;116.369214,39.9324;116.369614,39.932413;116.370556,39.932474;116.371489,39.93253;116.372956,39.932609;116.373056,39.932609;116.375833,39.932708;116.376858,39.932747;116.378902,39.93286;116.379544,39.932904;116.380013,39.93293;116.380221,39.932938;116.381224,39.932969;116.381949,39.932995;116.382908,39.933038;116.384141,39.933082;116.384631,39.933095;116.386315,39.933155;116.387023,39.933181;116.387118,39.933186;116.388294,39.933234;116.389158,39.933277;116.389653,39.933299;116.389731,39.933303;116.390043,39.93332;116.390174,39.933333;116.391428,39.933381;116.391845,39.933394;116.392813,39.933429;116.392895,39.933429;116.393303,39.933416;116.39372,39.933411;116.395091,39.933394;116.396254,39.933385;116.396324,39.933381;116.396471,39.933381;116.397726,39.933385;116.399635,39.933394;116.400477,39.933403;116.402747,39.933416;116.403099,39.933416;116.40428,39.933424;116.405069,39.933416;116.405768,39.933407;116.405846,39.933407;116.406328,39.933403;116.407548,39.933368;116.408793,39.933338;116.408889,39.933338;116.410056,39.933342;116.411133,39.933359;116.411918,39.933368;116.413433,39.93339;116.414796,39.933411;116.415547,39.933451;116.415933,39.933494;116.417101,39.933594;116.417192,39.933594;116.41888,39.93362;116.419392,39.933628;116.4198,39.933628;116.421033,39.933633;116.421823,39.933628;116.423646,39.933615;116.42431,39.93362;116.42579,39.933637;116.425946,39.933633;116.427031,39.93362;116.428012,39.93362;116.42855,39.933628;116.428672,39.933628;116.428711,39.933628;116.428876,39.933628;116.429609,39.933633;116.430282,39.933637;116.430464,39.933633;116.431458,39.933637;116.431641,39.933637;116.432305,39.933637;116.433103,39.933615;116.433168,39.933611;116.433255,39.933594;116.43342,39.933529;116.43342,39.933529;116.433494,39.933451;116.43365,39.933333;116.433724,39.933294;116.433811,39.933268;116.433906,39.933255;116.434371,39.933264;116.434466,39.933277;116.434497,39.93329;116.434536,39.933312;116.434644,39.933381;116.434783,39.933516;116.434857,39.933594;116.434857,39.933594;116.434948,39.933628;116.435056,39.933641;116.435269,39.93365;116.436619,39.933641;116.436619,39.933641;116.436606,39.93286;116.43661,39.932405;116.43661,39.932075;116.43661,39.931866;116.436602,39.931628;116.436623,39.930977;116.436701,39.93049;116.43678,39.930278;116.43678,39.930278;116.435699,39.930239;116.434965,39.930239;116.434497,39.93023;116.434497,39.93023;116.434475,39.930755;116.434466,39.930946;116.434457,39.931124",
"traffic":"10-1;33-2;50-0",
"timeSections": [
{
"name": "group1",
"sections": [
{
"costTime": 2,
"distance": 3,
"end": "23:59:02",
"start": "23:59:00"
},
{
"costTime": 671,
"distance": 2828,
"end": "00:10:02",
"start": "23:59:02"
},
{
"costTime": 1089,
"distance": 4165,
"end": "00:27:57",
"start": "00:10:02"
}
]
},
{
"name": "group2",
"sections": [
{
"costTime": 1762,
"distance": 6996,
"end": "00:28:22",
"start": "23:59:00"
}
]
}
],
"tolls": 0
},
{
"costTime": 1800,
"distance": 7914,
"points": "116.362743,39.932109;116.362743,39.93224;116.362743,39.932322;116.36474,39.932322;116.367188,39.932331;116.367947,39.932335;116.368064,39.932339;116.369214,39.9324;116.369614,39.932413;116.370556,39.932474;116.371489,39.93253;116.372956,39.932609;116.373056,39.932609;116.375833,39.932708;116.376858,39.932747;116.378902,39.93286;116.379544,39.932904;116.380013,39.93293;116.380221,39.932938;116.381224,39.932969;116.381949,39.932995;116.382908,39.933038;116.384141,39.933082;116.384631,39.933095;116.386315,39.933155;116.387023,39.933181;116.387118,39.933186;116.388294,39.933234;116.389158,39.933277;116.389653,39.933299;116.389731,39.933303;116.390043,39.93332;116.390174,39.933333;116.391428,39.933381;116.391845,39.933394;116.392813,39.933429;116.392895,39.933429;116.393303,39.933416;116.39372,39.933411;116.395091,39.933394;116.396254,39.933385;116.396324,39.933381;116.396471,39.933381;116.397726,39.933385;116.399635,39.933394;116.400477,39.933403;116.402747,39.933416;116.403099,39.933416;116.40428,39.933424;116.405069,39.933416;116.405768,39.933407;116.405846,39.933407;116.406328,39.933403;116.407548,39.933368;116.408793,39.933338;116.408793,39.933338;116.408802,39.932808;116.408854,39.932109;116.408867,39.931845;116.408885,39.931615;116.408893,39.931311;116.408906,39.931163;116.408958,39.929857;116.408989,39.928841;116.409006,39.928628;116.409023,39.928216;116.409054,39.927565;116.409067,39.927292;116.409149,39.927292;116.410777,39.927318;116.410777,39.927318;116.410773,39.927066;116.41076,39.926415;116.41076,39.926233;116.410777,39.92592;116.410781,39.925269;116.410729,39.925187;116.410747,39.924861;116.410755,39.924379;116.410872,39.924249;116.411133,39.924249;116.411914,39.924245;116.412687,39.924249;116.413524,39.924262;116.413889,39.924266;116.4151,39.924275;116.416037,39.924284;116.417092,39.924293;116.417504,39.924293;116.418529,39.924293;116.419596,39.924297;116.419731,39.924306;116.420538,39.924314;116.420538,39.924314;116.422218,39.924323;116.422969,39.924323;116.424076,39.92434;116.424857,39.924332;116.426185,39.924353;116.426311,39.924358;116.427391,39.924358;116.427843,39.924358;116.428212,39.924358;116.428859,39.924362;116.429709,39.924366;116.430629,39.924366;116.43168,39.924379;116.432617,39.924384;116.432648,39.924384;116.433103,39.924388;116.433711,39.924401;116.433815,39.924379;116.433872,39.924336;116.433872,39.924336;116.43388,39.924314;116.433976,39.924201;116.434019,39.924175;116.43411,39.924136;116.434262,39.924123;116.434505,39.924123;116.434857,39.924136;116.434931,39.924154;116.435004,39.924175;116.435109,39.924249;116.435165,39.924314;116.435169,39.924332;116.435217,39.924497;116.435187,39.924583;116.435122,39.92467;116.435009,39.924731;116.434891,39.92477;116.434891,39.92477;116.434839,39.925625;116.434809,39.92622;116.434727,39.926502;116.434635,39.926753;116.434631,39.926944;116.434627,39.927049;116.434609,39.927526;116.434575,39.928398;116.434575,39.928572;116.434566,39.928676;116.434527,39.929527;116.434497,39.93023;116.434475,39.930755;116.434466,39.930946;116.434457,39.931124",
"traffic":"10-1;33-2;50-0",
"timeSections": [
{
"name": "group1",
"sections": [
{
"costTime": 2,
"distance": 3,
"end": "23:59:02",
"start": "23:59:00"
},
{
"costTime": 671,
"distance": 2828,
"end": "00:10:02",
"start": "23:59:02"
},
{
"costTime": 1148,
"distance": 5083,
"end": "00:28:56",
"start": "00:10:02"
}
]
},
{
"name": "group2",
"sections": [
{
"costTime": 1821,
"distance": 7914,
"end": "00:29:21",
"start": "23:59:00"
}
]
}
],
"tolls": 0
},
{
"costTime": 1860,
"distance": 7938,
"points": "116.362743,39.932109;116.362743,39.93224;116.362743,39.932322;116.36474,39.932322;116.367188,39.932331;116.367947,39.932335;116.368064,39.932339;116.369214,39.9324;116.369614,39.932413;116.370556,39.932474;116.371489,39.93253;116.372956,39.932609;116.373056,39.932609;116.375833,39.932708;116.376858,39.932747;116.378902,39.93286;116.379544,39.932904;116.380013,39.93293;116.380221,39.932938;116.381224,39.932969;116.381949,39.932995;116.382908,39.933038;116.384141,39.933082;116.384631,39.933095;116.386315,39.933155;116.387023,39.933181;116.387118,39.933186;116.388294,39.933234;116.389158,39.933277;116.389653,39.933299;116.389731,39.933303;116.390043,39.93332;116.390174,39.933333;116.391428,39.933381;116.391845,39.933394;116.392813,39.933429;116.392895,39.933429;116.393303,39.933416;116.39372,39.933411;116.395091,39.933394;116.396254,39.933385;116.396324,39.933381;116.396471,39.933381;116.397726,39.933385;116.399635,39.933394;116.400477,39.933403;116.402747,39.933416;116.403099,39.933416;116.40428,39.933424;116.405069,39.933416;116.405768,39.933407;116.405846,39.933407;116.406328,39.933403;116.407548,39.933368;116.408793,39.933338;116.408889,39.933338;116.410056,39.933342;116.411133,39.933359;116.411918,39.933368;116.413433,39.93339;116.414796,39.933411;116.415547,39.933451;116.415933,39.933494;116.417101,39.933594;116.417192,39.933594;116.41888,39.93362;116.419392,39.933628;116.4198,39.933628;116.421033,39.933633;116.421823,39.933628;116.423646,39.933615;116.42431,39.93362;116.42579,39.933637;116.42579,39.933637;116.425768,39.933016;116.42576,39.9325;116.425829,39.932313;116.425825,39.931484;116.425842,39.930152;116.426003,39.929249;116.425903,39.929036;116.426003,39.928407;116.426055,39.928268;116.426085,39.928073;116.42612,39.927378;116.42615,39.926636;116.426176,39.926059;116.426185,39.925286;116.426185,39.924592;116.426185,39.924475;116.426311,39.924358;116.427391,39.924358;116.427843,39.924358;116.428212,39.924358;116.428859,39.924362;116.429709,39.924366;116.430629,39.924366;116.43168,39.924379;116.432617,39.924384;116.432648,39.924384;116.433103,39.924388;116.433711,39.924401;116.433815,39.924379;116.433872,39.924336;116.433872,39.924336;116.43388,39.924314;116.433976,39.924201;116.434019,39.924175;116.43411,39.924136;116.434262,39.924123;116.434505,39.924123;116.434857,39.924136;116.434931,39.924154;116.435004,39.924175;116.435109,39.924249;116.435165,39.924314;116.435169,39.924332;116.435217,39.924497;116.435187,39.924583;116.435122,39.92467;116.435009,39.924731;116.434891,39.92477;116.434891,39.92477;116.434839,39.925625;116.434809,39.92622;116.434727,39.926502;116.434635,39.926753;116.434631,39.926944;116.434627,39.927049;116.434609,39.927526;116.434575,39.928398;116.434575,39.928572;116.434566,39.928676;116.434527,39.929527;116.434497,39.93023;116.434475,39.930755;116.434466,39.930946;116.434457,39.931124",
"traffic":"10-1;33-2;50-0",
"timeSections": [
{
"name": "group1",
"sections": [
{
"costTime": 2,
"distance": 3,
"end": "23:59:02",
"start": "23:59:00"
},
{
"costTime": 671,
"distance": 2828,
"end": "00:10:02",
"start": "23:59:02"
},
{
"costTime": 1158,
"distance": 5107,
"end": "00:29:06",
"start": "00:10:02"
}
]
},
{
"name": "group2",
"sections": [
{
"costTime": 1831,
"distance": 7938,
"end": "00:29:31",
"start": "23:59:00"
}
]
}
],
"tolls": 0
}
]
},
"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产品时遇到问题,请先参考提供的相关资料.如仍未解决,请与我们联系.您可以通过下列途径获得满意答复: 在线支持:https://lbs.amap.com/