Profiles

The service supports calculation of routing matrices with routes of arbitrary length. However, this comes with two limitations.

  1. Only predefined sets of options are supported. Such a set of options we call a profile.
  2. Only non-time aware routing is supported. In particular, dynamic traffic information is not taken into account and only free-flow speeds based on historical traffic are applied.

The service supports a set of predefined profiles, which is available under the endpoint /v1/profiles. This endpoint returns the list of profiles with their corresponding profileId and predefined options.

Request

To calculate a matrix using a profile, specify a profile id from the above list as profile parameter and set the required region definition parameter to the special variant world.

Specifying a profile means overwriting all default values of the request options by values from the profile definition. No other request options must be specified. The response option matrixAttributes can be still used to configure what should be included in the response.

Example:

{
    "origins": [
        { "lat": 52.54, "lng": 13.40 },  // Berlin
        { "lat": 50.43, "lng": 30.52 },  // Kyiv
        { "lat": 51.50, "lng": -0.08 },  // London
        { "lat": 40.40, "lng": -3.68 },  // Madrid
        { "lat": 55.75, "lng": 37.60 },  // Moscow
        { "lat": 48.87, "lng":  2.33 },  // Paris
        { "lat": 41.90, "lng": 12.48 }   // Rome
    ],
    "profile": "carFast",   // one of the profile IDs from the list /v1/profiles
    "regionDefinition": {
        "type": "world"     // required
    },
    "matrixAttributes": ["travelTimes", "distances"]
}

Traffic

When a profile is used, the calculation of the matrix only considers free-flow speed based on the historical traffic. Therefore the departureTime parameter is always set to the special value any for all profiles. This can be explicitly seen in the list of profiles under the endpoint /v1/profiles.

results matching ""

    No results matching ""