产品亮点
产品说明
| 接口说明 |
接口描述：提供货车路线规划功能。
编码格式：UTF-8
| 参数名称 | 参数类型 | 参数说明 | 备注 |
| origin | string | 起点经纬度，或起点名称+经纬度，此时名称只用于展示。 格式如：北京市海淀区中关村软件园|116.296972,40.049057 | 必填参数 |
| destination | string | 终点经纬度，或终点名称+经纬度，此时名称只负责展示。 格式如：中关村皇冠假日酒店写字楼| 116.32259,39.97554 | 必填参数 |
| coord_type | string | 坐标类型，可选参数，默认为gcj02。允许的值为： gcj02（国测局坐标）、 wgs84（gps设备获取的坐标）。 | 可选参数 |
| waypoints | string | 途经点，最多支持设置16组途经点。经、纬度之间用“,”分隔，坐标点之间用"；"分隔。格式如：经度,纬度;经度,纬度;经度,纬度。 | 可选参数 |
| tactics | int | 路径规划策略，对应的状态码如下： 0：费用优先（不走收费路段的最快道路）； 2：国道优先； 4：省道优先； 5：不走高速； 6：多策略1（同时返回速度优先、费用优先、距离优先的路径各一条）； 10：不走快速路（不走快速路，不包含高速路）； 11：速度优先（快速路优先）； 12：距离优先（路径最短）。 默认值为11。 | 可选参数 |
| avoidpolygons | string | 区域避让，支持32个避让区域，每个区域最多可有16个顶点 。 经、纬度之间用","分割，小数点后不超过6位，坐标点之间用";"分隔，区域之间用"|"分隔。如果是四边形则有四个坐标点，如果是五边形则有五个坐标点。 格式如：经度,纬度;经度,纬度;经度,纬度|经度,纬度;经度,纬度;经度,纬度...... 说明：当避让道路与避让区域同时输入时，避让道路有效。 | 可选参数 |
| avoidroad | string | 避让道路名称，支持输入一条道路名称。 | 选填参数 |
| startTime | string | 出发时间戳，10位 格式如：108343402 | 选填参数 |
| plateNo | string | 车牌号所在省份的adcode 格式如：110000 | 选填参数 |
| truckHeight | string | 车高(m) 格式如：4.5 | 选填参数 |
| truckWidth | string | 车宽(m) 格式如：5.5 | 选填参数 |
| truckWeight | string | 车重(t) 格式如：10 | 选填参数 |
| callback | string | 回调函数。用户定义的函数名称，仅当输出json格式的返回结果时该参数有效。 | 可选参数 |
| output | string | 返回结果的格式，支持XML、JSON，不区分大小写，默认为json格式。 | 可选参数 |
| out_coord_type | string | 坐标类型，默认为gcj02。允许的值为： gcj02： 国测局坐标 wgs84： gps设备获取的坐标 baidu : 百度坐标 | 可选参数 |
| 返回参数 | 参数说明 | 备注 | |||
| status | 是否返回成功。 | 状态，0为成功，其他为失败。 | |||
| message | 状态说明。 | 状态码对应的信息，如，“ok”。 | |||
| type | 返回数据类型。 | l 1：起终点是模糊的，此时给出的是选择页面； l 2：起终点都是明确的，直接跳转。 | |||
| info | 版权信息。 | - | |||
| result | 返回结果。 | - | |||
|
| routes | distance | 方案距离。 | 单位，米。 | |
| duration | 导航用时。 | 单位，秒。 | |||
| tactics | 路径规划策略。 | 值为路径规划策略对应的状态值。 | |||
| steps | area | 标示该路段是否在城市内部。 | l 0：不在城市内部；（默认） l 1：在城市内部。 | ||
| direction | 进入道路的角度。 | 枚举值，返回值在0-11之间的一个值，共12个枚举值，以30度递进，即每个值代表角度范围为30度；其中返回"0"代表345度到15度，以此类推，返回"11"代表315度到345度"；分别代表的含义是：0-[345°-15°]；1-[15°-45°]；2-[45°-75°]；3-[75°-105°]；4-[105°-135°]；5-[135°-165°]；6-[165°-195°]；7-[195°-225°]；8-[225°-255°]；9-[255°-285°]；10-[285°-315°]；11-[315°-345°] | |||
| distance | 路段距离。 | 单位：米。 | |||
| duration | 路段耗时。 | 单位：秒。 | |||
| instruction | 路段描述。 | - | |||
| path | 路段位置坐标描述。 | 如"116.30815169816,40.057096534337"。 | |||
| pois | 途径兴趣点poi信息。 | - | |||
| ispasspoi | 是否是途经点。 | l 0：不是。 l 1：是。 | |||
| turn | 机动转向点，包括基准八个方向、环岛、分歧等。 | 枚举值，返回0-16之间的一个值，共17个枚举值；分别代表的含义是：0-无效；1-直行；2-右前方转弯；3-右转；4-右后方转弯；5-掉头；6-左后方转弯；7-左转；8-左前方转弯；9-左侧；10-右侧；11-分歧-左；12-分歧中央；13-分歧右；14-环岛；15-进渡口；16-出渡口（9~13尚未支持）。 | |||
| limit | 是否包含限制信息 |
| |||
| stepOrigin Location | l lng：路段起点经度。 l lat：路段起点纬度。 | - | |||
| stepDestination Location | l lng：路段终点经度。 l lat：路段终点纬度。 | - | |||
| toll | 过路费。 | - | |||
| originLocation | 起点经纬度坐标。 | - | |||
| lng | 经度。 | - | |||
| lat | 纬度。 | - | |||
| destinationLocation | 终点经纬度坐标。 | - | |||
| lng | 经度。 | - | |||
| lat | 纬度。 | - | |||
| origin | area_id | 起点所在城市代码。 | 如：北京 131 | ||
| cname | 城市名称。 | - | |||
| uid | 起点的id。 | - | |||
| wd | 起点的搜索关键字。 | - | |||
| originPt | 起点经纬度。 | - | |||
| lng | 经度。 | - | |||
| lat | 纬度。 | - | |||
| destination | area_id | 终点所在城市代码。 | - | ||
| cname | 终点城市名称。 | - | |||
| uid | 终点id。 | - | |||
| wd | 终点的搜索关键字。 | - | |||
| destinationPt | 终点经纬度。 | - | |||
| lng | 经度。 | - | |||
| lat | 纬度。 | - | |||
| taxi | - | - | |||
| traffic_condition | 路况评价。 | l 0：无路况； l 1：畅通； l 2：缓行； l 3：拥堵。 | |||
| 返回示例 |
| { "result": { "routes": [ { "duration": "1260", "distance": "9749", "tactics": "11", "destinationLocation": { "lng": "116.322591", "lat": "39.97554" }, "steps": [ { "area": "", "duration": "60", "path": "116.29644,40.04896;116.29625,40.04962", "stepDestinationLocation": { "lng": "116.29625", "lat": "40.04962" }, "distance": "75", "instruction": "软件园二号路", "limit": 0, "turn": "0", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.29644", "lat": "40.04896" } }, { "area": "", "duration": "60", "path": "116.29622,40.049618;116.29658,40.04839;116.296585,40.048355;116.29675,40.047817;116.29691,40.047283", "stepDestinationLocation": { "lng": "116.29691", "lat": "40.047283" }, "distance": "262", "instruction": "软件园二号路", "limit": 0, "turn": "7", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.29622", "lat": "40.049618" } }, { "area": "", "duration": "60", "path": "116.29694,40.047256;116.29738,40.04733;116.29869,40.04757;116.29943,40.047695;116.29975,40.047787", "stepDestinationLocation": { "lng": "116.29975", "lat": "40.047787" }, "distance": "245", "instruction": "软件园二号路", "limit": 0, "turn": "3", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.29694", "lat": "40.047256" } }, { "area": "", "duration": "240", "path": "116.29975,40.047787;116.30036,40.04679;116.30082,40.04608;116.30169,40.044662;116.30183,40.044468;116.30186,40.044407;116.30203,40.044132;116.30286,40.042824;116.30335,40.042046;116.30363,40.04159;116.303986,40.041004;116.30451,40.04016;116.30484,40.03962;116.30507,40.03917;116.30519,40.03893;116.30586,40.037384;116.30624,40.036545;116.30658,40.035713;116.30674,40.035366;116.306786,40.035255;116.30688,40.03506;116.307465,40.03359;116.307686,40.033108;116.3078,40.032883;116.30789,40.032757;116.3079,40.03274;116.30804,40.032513;116.30842,40.032013;116.30859,40.03183;116.308784,40.03165;116.30903,40.03141;116.30931,40.031166;116.309395,40.0311;116.30974,40.030865;116.310036,40.03068;116.31057,40.03035;116.311554,40.029762;116.31201,40.02948;116.312065,40.029446;116.31235,40.02927", "stepDestinationLocation": { "lng": "116.31235", "lat": "40.02927" }, "distance": "2326", "instruction": "上地西路", "limit": 0, "turn": "10", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.29975", "lat": "40.047787" } }, { "area": "", "duration": "300", "path": "116.31235,40.029266;116.31239,40.02921;116.31285,40.028908;116.312965,40.02882;116.313065,40.02874;116.31325,40.028572;116.31326,40.028534;116.313354,40.02791;116.31352,40.026276;116.313545,40.026207;116.3136,40.02559;116.31371,40.024612;116.313835,40.02359;116.31391,40.022877;116.31399,40.022327;116.314026,40.02195;116.31405,40.021755;116.31415,40.020824;116.31418,40.020668;116.31419,40.020504;116.31424,40.02014;116.31425,40.020042;116.31427,40.019943;116.3143,40.01985;116.31432,40.019787;116.314354,40.01971;116.31441,40.019604;116.31445,40.019535;116.31451,40.01947;116.314964,40.01897;116.31573,40.018322;116.31575,40.018303;116.31611,40.01796;116.31638,40.01768;116.31684,40.0172;116.31701,40.016987;116.3172,40.016705;116.31731,40.01654;116.31741,40.016376;116.31753,40.016182;116.317566,40.016098;116.31767,40.015827;116.317795,40.015495;116.317795,40.015488;116.31785,40.01536;116.31788,40.015217;116.31792,40.015007;116.317955,40.01484;116.31804,40.014206;116.3181,40.01375;116.318146,40.01348;116.318214,40.01287;116.31823,40.012756;116.31823,40.012707;116.31823,40.012665;116.31826,40.012478;116.318275,40.012383;116.3184,40.011467;116.31849,40.010666;116.31853,40.010338;116.318695,40.009098;116.31871,40.009033;116.31882,40.00822;116.318825,40.00809;116.318886,40.007553;116.31892,40.007362;116.318924,40.00719;116.31891,40.00701;116.31888,40.006924;116.31881,40.006763;116.31872,40.006638;116.31865,40.00656;116.318565,40.006493;116.31842,40.00641;116.31834,40.00639;116.31828,40.00637;116.318184,40.00635;116.31805,40.00632;116.31774,40.006287;116.31743,40.006245;116.31722,40.006218;116.31701,40.006187;116.31674,40.006145;116.31658,40.006107;116.31639,40.00604;116.3162,40.005962;116.31597,40.005848;116.315765,40.005714;116.31555,40.005547;116.3154,40.00541;116.31528,40.00525;116.31517,40.005093;116.315125,40.004997;116.315094,40.00492;116.315056,40.00481;116.31503,40.00472;116.31502,40.004627;116.314995,40.004444;116.314995,40.004272;116.314995,40.002502", "stepDestinationLocation": { "lng": "116.314995", "lat": "40.002502" }, "distance": "3284", "instruction": "信息路,中关村北大街", "limit": 0, "turn": "8", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.31235", "lat": "40.029266" } }, { "area": "", "duration": "180", "path": "116.314995,40.0025;116.315056,40.002365;116.315056,40.001926;116.31506,40.001286;116.31507,40.00109;116.31507,40.00085;116.31507,40.00018;116.31502,39.999928;116.31502,39.99934;116.31502,39.9991;116.315056,39.998615;116.31519,39.99724;116.3152,39.997166;116.31538,39.995396;116.3155,39.99419;116.31561,39.99305;116.315704,39.992165;116.31571,39.992104;116.31573,39.991844;116.315865,39.990578;116.3159,39.990097;116.31597,39.98923;116.316025,39.98869;116.31607,39.98808;116.31611,39.987595;116.31616,39.986725", "stepDestinationLocation": { "lng": "116.31616", "lat": "39.986725" }, "distance": "1745", "instruction": "中关村北大街", "limit": 0, "turn": "2", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.314995", "lat": "40.0025" } }, { "area": "", "duration": "120", "path": "116.31616,39.986717;116.31609,39.98646;116.31609,39.986317;116.31613,39.98595;116.316216,39.98571;116.31618,39.985237;116.31626,39.98471;116.3164,39.984253;116.31641,39.984184;116.31642,39.984093;116.31646,39.983753;116.31653,39.982643;116.31654,39.982582;116.31654,39.982483;116.31656,39.982204;116.31668,39.980865;116.31668,39.98082;116.31676,39.980217;116.316765,39.980003;116.316765,39.979935;116.31676,39.97972;116.31673,39.97944;116.316696,39.979084;116.31668,39.979027;116.31667,39.97885;116.31668,39.978737;116.31668,39.97863;116.31671,39.97851;116.316734,39.978443;116.317024,39.97742;116.3171,39.97718;116.31734,39.976406;116.31743,39.976112;116.31746,39.976032", "stepDestinationLocation": { "lng": "116.31746", "lat": "39.976032" }, "distance": "1118", "instruction": "中关村北大街,中关村大街", "limit": 0, "turn": "7", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.31616", "lat": "39.986717" } }, { "area": "", "duration": "60", "path": "116.31764,39.97596;116.31785,39.97596;116.319824,39.976025;116.32005,39.976032;116.32092,39.97606;116.321106,39.976067;116.32253,39.976112", "stepDestinationLocation": { "lng": "116.32253", "lat": "39.976112" }, "distance": "416", "instruction": "知春路", "limit": 0, "turn": "2", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.31764", "lat": "39.97596" } }, { "area": "", "duration": "60", "path": "116.32253,39.976048;116.32302,39.976063;116.323456,39.97608", "stepDestinationLocation": { "lng": "116.323456", "lat": "39.97608" }, "distance": "78", "instruction": "知春路", "limit": 0, "turn": "3", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.32253", "lat": "39.976048" } }, { "area": "", "duration": "60", "path": "116.323456,39.97608;116.323456,39.975967;116.32347,39.975864;116.32349,39.975647", "stepDestinationLocation": { "lng": "116.32349", "lat": "39.975647" }, "distance": "48", "instruction": "无名道路", "limit": 0, "turn": "1", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.323456", "lat": "39.97608" } }, { "area": "", "duration": "60", "path": "116.32349,39.975643;116.32351,39.975277;116.32306,39.975258;116.3226,39.97524;116.32259,39.975536", "stepDestinationLocation": { "lng": "116.32259", "lat": "39.975536" }, "distance": "152", "instruction": "无名道路", "limit": 0, "turn": "0", "ispasspoi": "0", "pois": "", "direction": "0", "stepOriginLocation": { "lng": "116.32349", "lat": "39.975643" } } ], "toll": "0", "originLocation": { "lng": "116.296972", "lat": "40.049057" } } ], "traffic_condition": "", "origin": { "uid": "", "originPt": { "lng": "116.296972", "lat": "40.049057" }, "cname": "", "area_id": "", "wd": "" }, "destination": { "uid": "", "destinationPt": { "lng": "116.322591", "lat": "39.97554" }, "cname": "", "area_id": "", "wd": "" }, "taxi": "" }, "message": "ok", "type": "2", "status": "0", "info": "copyright:@leador" } |