1. Matrices
GraphHopper Directions API
  • Routing
    • Calculate a route
      GET
    • Calculate a route
      POST
  • Isochrones
    • Compute an isochrone
      GET
  • Matrices
    • Compute a matrix
      POST
    • Compute a matrix
      GET
    • Submit a matrix computation job
      POST
    • Retrieve result of a matrix computation job
      GET
  • Map Matching
    • Map-match a GPX file
      POST
  • Geocoding
    • Geocoding Endpoint
      GET
  • Route Optimization
    • Solve a route optimization problem
      POST
    • Submit a route optimization job
      POST
    • Retrieve solution of a route optimization job
      GET
  • Clustering
    • Solve a clustering problem
      POST
    • Submit a clustering job
      POST
    • Retrieve solution of a clustering job
      GET
  • Custom Profiles
    • Create a custom routing profile
      POST
    • List your custom routing profiles
      GET
    • Submit a profile creation job
      POST
    • Retrieve result of a profile creation job
      GET
    • Delete a custom routing profile
      DELETE
  • 数据模型
    • Schemas
      • ClusterResponse
      • Cluster
      • ClusterRequest
      • ClusterConfiguration
      • Clusters
      • ClusterCustomer
      • ClusterCustomerAddress
      • ClusterConfigurationRouting
      • ClusterConfigurationClustering
      • GeocodingResponse
      • GeocodingLocation
      • GeocodingPoint
      • MatrixRequest
      • SymmetricalMatrixRequest
      • MatrixResponse
      • RouteRequest
      • CustomModel
      • CustomModelForProfile
      • ProfileRequest
      • ProfileResponse
      • ProfileGetResponse
      • RouteResponse
      • EncodedLineString
      • BBox
      • FeatureCollection
      • RouteResponsePath
      • ResponseInfo
      • IsochroneResponse
      • IsochroneResponsePolygon
      • LineString
      • Polygon
      • GHError
      • JobId
      • BadRequest
      • ErrorMessage
      • InternalErrorMessage
      • Request
      • Vehicle
      • VehicleProfileId
      • Shift
      • Algorithm
      • Address
      • ResponseAddress
      • SnappedWaypoint
      • DriveTimeBreak
      • TimeWindowBreak
      • VehicleType
      • Service
      • Shipment
      • Pickup
      • Stop
      • TimeWindow
      • PreferredVehicle
      • Configuration
      • Optimization
      • Routing
      • Objective
      • CostMatrix
      • GroupRelation
      • JobRelation
      • Response
      • Solution
      • Detail
      • Route
      • RoutePoint
      • Activity
  1. Matrices

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: ********************
or
Body 参数application/json

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
Built with