估价路径规划最后更新时间: 2025年07月02日

法律声明

版权所有©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	CKQPS_HAS_EXCEEDED_THE_LIMIT	某个Key使用某个服务接口QPS超出限制
21	10021	CIQPS_HAS_EXCEEDED_THE_LIMIT	来自于同一IP的访问，使用某个服务QPS超出限制
22	10022	CIKQPS_HAS_EXCEEDED_THE_LIMIT	某个Key，来自于同一IP的访问，使用某个服务QPS 超出限制
23	10023	KQPS_HAS_EXCEEDED_THE_LIMIT	某个KeyQPS超出限制
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	TRACK_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/

估价路径规划 最后更新时间: 2025年07月02日