1. Custom Profiles
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. Custom Profiles

Submit a profile creation job

POST
/profiles/calculate
An alternate endpoint for computing a profile for a large boundary 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.

请求参数

Authorization
API Key
在 query 添加参数
key
示例:
key: ********************
or
Body 参数application/json必填

示例
{
    "bounds": {
        "bbox": [
            11.45462,
            48.00954,
            11.77322,
            48.2076
        ]
    },
    "custom_model": {
        "priority": [
            {
                "if": "road_access == PRIVATE",
                "multiply_by": "0"
            },
            {
                "if": "road_class == MOTORWAY",
                "multiply_by": "0"
            }
        ]
    },
    "profile": "car"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/profiles/calculate?key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "bounds": {
        "bbox": [
            11.45462,
            48.00954,
            11.77322,
            48.2076
        ]
    },
    "custom_model": {
        "priority": [
            {
                "if": "road_access == PRIVATE",
                "multiply_by": "0"
            },
            {
                "if": "road_class == MOTORWAY",
                "multiply_by": "0"
            }
        ]
    },
    "profile": "car"
}'

返回响应

🟢200成功
application/json
A jobId you can use to retrieve the calculated profile.
Headers

Bodyapplication/json

示例
{
    "job_id": "44886560-b584-4da5-b245-768151dacd8f"
}
修改于 2025-11-25 06:18:54
上一页
List your custom routing profiles
下一页
Retrieve result of a profile creation job
Built with