Submit a matrix computation job

POST

/matrix/calculate

An alternate endpoint for computing a large matrix asynchronously, where a request against the regular
endpoint would result in a timeout.

The request format is the same, but instead of the result, you are given a job identification number that
you can use to retrieve the result once it is available.

In most cases, prefer the regular endpoints.

Here are some full examples via curl:

Pick the returned job_id and use it in the next GET requests:

When the calculation is finished (status:finished) the JSON response will contain the full matrix JSON under solution:

Please note that if an error occured while calculation the JSON will not have a status but contain directly the error message e.g.:

{"message":"Cannot find from_points: 1"}

And the optional hints array.

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

key: ********************

Body 参数application/json

示例

{
    "from_points": [
        [
            -0.11379003524780275,
            51.53664617804063
        ],
        [
            -0.10866165161132814,
            51.538621486960956
        ],
        [
            -0.11059284210205078,
            51.53245503603458
        ]
    ],
    "to_points": [
        [
            -0.09576559066772462,
            51.512882367963456
        ],
        [
            -0.08797645568847656,
            51.51317615367198
        ]
    ],
    "from_point_hints": [
        "Copenhagen Street",
        "Richmond Avenue",
        "White Lion Street"
    ],
    "to_point_hints": [
        "Cannon",
        "Cornhill"
    ],
    "out_arrays": [
        "weights",
        "times",
        "distances"
    ],
    "vehicle": "car"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/matrix/calculate?key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "from_points": [
        [
            -0.11379003524780275,
            51.53664617804063
        ],
        [
            -0.10866165161132814,
            51.538621486960956
        ],
        [
            -0.11059284210205078,
            51.53245503603458
        ]
    ],
    "to_points": [
        [
            -0.09576559066772462,
            51.512882367963456
        ],
        [
            -0.08797645568847656,
            51.51317615367198
        ]
    ],
    "from_point_hints": [
        "Copenhagen Street",
        "Richmond Avenue",
        "White Lion Street"
    ],
    "to_point_hints": [
        "Cannon",
        "Cornhill"
    ],
    "out_arrays": [
        "weights",
        "times",
        "distances"
    ],
    "vehicle": "car"
}'

返回响应

🟢200成功

application/json

A jobId you can use to retrieve your solution from the server.

Headers

Bodyapplication/json

示例

{
    "job_id": "44886560-b584-4da5-b245-768151dacd8f"
}

修改于 2025-11-25 06:18:54

Compute a matrix

Retrieve result of a matrix computation job