批量算路-驾车

功能介绍

提供多点之间驾车路径规划功能。

场景描述

适用于高并发场景，如网约车派单等场景，同时发起多个起终点之间的算路，筛选所需要的订单起终点。

使用约束

• 仅提供10000km以内的路径规划能力
• 起点数乘以终点数需不超过100。
• 如需使用，请联系我们（在线提单）申请配额。

接口原型

查询参数

请求参数

Request Body

请求示例

POST https://mapapi.cloud.huawei.com/mapApi/v1/routeService/drivingMatrix?key=API KEY HTTP/1.1 
Content-Type: application/json 
Accept: application/json 
{ 
    "origins": [ 
            {"lng": -1.894679, "lat": 54.974887}, 
            {"lng": -2.882682, "lat": 54.857616} 
    ], 
    "destinations": [ 
            {"lng": -1.744955, "lat": 54.775040} 
    ], 
    "avoid": [1,2], 
    "trafficMode":2, 
    "language": "en" 
}

响应参数

状态码为200时：

Response Header

Response Body

响应示例

状态码为200时：

HTTP/1.1 200 OK
Content-type: application/json
{
    "originAddresses": [
        "12, Springfield, Prudhoe, Ovington, Northumberland, England, NE42 6EH, the United Kingdom",
        "Saint Cuthbert Without, Carlisle, Cumbria, England, the United Kingdom"
    ],
    "returnCode": "0",
    "destinationAddresses": [
        "Hedleyhope, Durham, England, DH7 9EY, the United Kingdom"
    ],
    "rows": [
        {
            "cells": [
                {
                    "duration": 2158.559,
                    "durationText": "35min",
                    "distance": 36129.102,
                    "distanceText": "36.1km",
                    "status": 0
                }
            ]
        },
        {
            "cells": [
                {
                    "duration": 4856.301,
                    "durationText": "1h20min",
                    "distance": 104685.306,
                    "distanceText": "104.7km",
                    "status": 0
                }
            ]
        }
    ],
    "returnDesc": "OK"
}

调用示例

public class MatrixService {
    public static final String ROOT_URL = "https://mapapi.cloud.huawei.com/mapApi/v1/routeService/drivingMatrix";

    public static final String connection = "?key=";

    public static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");

    public static void matrixDriving(String apiKey) throws UnsupportedEncodingException {
        JSONObject json = new JSONObject();
        JSONArray origin = new JSONArray();
        JSONObject startingPoint_1 = new JSONObject();
        JSONObject startingPoint_2 = new JSONObject();
        JSONArray destination = new JSONArray();
        JSONObject endPoint = new JSONObject();

        try {
            startingPoint_1.put("lng", -1.894679);
            startingPoint_1.put("lat", 54.974887);

            startingPoint_2.put("lng", -2.882682);
            startingPoint_2.put("lat", 54.857616);

            origin.put(0, startingPoint_1);
            origin.put(1, startingPoint_2);

            endPoint.put("lng", -1.744955);
            endPoint.put("lat", 54.775040);

            destination.put(0, endPoint);

            json.put("origins", origin);
            json.put("destinations", destination);
            json.put("language", "en");

        } catch (JSONException e) {
            Log.e("error", e.getMessage());
        }
        RequestBody body = RequestBody.create(JSON, String.valueOf(json));

        OkHttpClient client = new OkHttpClient();
        Request request =
            new Request.Builder().url(ROOT_URL + connection + URLEncoder.encode(apiKey, "UTF-8"))
                .post(body)
                .build();

        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                Log.e("MatrixDriving", e.toString());
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                Log.d("MatrixDriving", response.body().string());
            }
        });
    }
}

Postman调试

您可以使用Postman在线调试此接口。