Calculate Matrix

GET

https://api.woosmap.com/distance/distancematrix/json

Get distances and durations for a matrix of origins and destinations, based on the recommended route between start and end points for a specified travel mode.

Traffic calculations use the optional departure_time parameter. Matrix requests reject any non-null arrival_time value with HTTP 200 and INVALID_REQUEST. Omitting arrival_time, or setting it to JSON null in a POST body, is accepted.

Rate limit: 20 requests/2s GET and POST

Elements limit: 1000 elements/1s GET and POST

Rate limit with TRAFFIC: 20 requests/2s GET and POST

Elements limit with TRAFFIC: 1000 elements/1sGET and POST

Authorization

key

apiKey query

Public key of the project (starts with woos-) or an API key (a UUID).

private_key

apiKey query

Private key with or without write permission.

X-Api-Key

apiKey header

Private key with or without write permission.

Header Parameters

accept-language

string

Query Parameters

origins

string required

The starting points. You can supply one or more locations, in the form of latitude,longitude coordinates, separated by the pipe character |. Ensure that no space exists between the latitude and longitude values.

In order to reduce URL size, encoded polylines are also supported using enc:<encoded-polyline>:

Example: 48.709,2.403|48.768,2.338

destinations

string required

The ending points. You can supply one or more locations, in the form of latitude,longitude coordinates, separated by the pipe character |. Ensure that no space exists between the latitude and longitude values.

In order to reduce URL size, encoded polylines are also supported using enc:<encoded-polyline>:

Example: 48.709,2.403|48.768,2.338

mode

string Defaults to driving

Specifies the mode of transport to use for the calculation.

Available options: driving, walking, cycling

method

string Defaults to time

Specifies how to compute the route between the start point and the end point:

• time: fastest route
• distance: shortest route

Available options: time, distance

units

string Defaults to metric

Specifies the unit system to use when displaying results.

Available options: metric, imperial

language

string Defaults to en

The language code, indicating in the language the response should be in.

If not defined the header Accept-Language of the request will be checked before defaulting to en.

Show 28 enum values Hide 28 enum values

en

fr

bg

ca

cs

da

de

el

es

et

fi

he

hi

hu

it

ja

nb

nl

pl

pt

ro

ru

sk

sl

sv

tr

uk

zh

avoid

string

A list of features that you want to avoid. Valid values are tolls, highways, ferries or polygons coordinates whose vertex latlng are separated by a semicolon ;.

To add multiple features, separate them with the pipe | character.

Example: tolls

departure_time

string

Specify your desired departure time.

By using this parameter, Distance will calculate the duration with traffic. Valid values are a UNIX timestamp (e.g. 1600799173 for the date: 22/09/2020 20:26:13) or now.

Example: 1600799173

elements

string Defaults to distance

Specifies element values that will be part of the API response (distance and/or duration).

Available options: distance, duration, duration_distance

Response

200 application/json

Successful Response

status

string Defaults to OK

The status of the response

• OK: The response contains a valid result.
• INVALID_REQUEST: The request could not be processed.
• MAX_ELEMENTS_EXCEEDED: The product of origins and destinations exceeds the per-query limit (fixed at 200 elts/query).
• MAX_ROUTE_LENGTH_EXCEEDED: One of the requested routes is too long and the matrix/route cannot be processed (The limit is 1000km for routes and 1000km for matrices when driving, 250km and 200km when walking, 500km and 500km when cycling).
• REQUEST_DENIED: The API key provided is invalid or does not allow access to this service etc..
• BACKEND_ERROR: The server encountered an unexpected error.
• BACKEND_UNAVAILABLE: The service is temporarily unavailable or the request timed out.
• OVER_QUERY_LIMIT: The request was denied due to the rate limit (see Usage Limits).
• ZERO_RESULTS: No route could be found between the origin and destination.

Show 9 enum values Hide 9 enum values

OK

INVALID_REQUEST

MAX_ELEMENTS_EXCEEDED

MAX_ROUTE_LENGTH_EXCEEDED

REQUEST_DENIED

BACKEND_ERROR

BACKEND_UNAVAILABLE

OVER_QUERY_LIMIT

ZERO_RESULTS

rows

object[] required

Contains an array of elements for each pair of origin and destination

Show 1 propertiesHide 1 properties

rows. elements

object[] required

An array of each route element.

Errors

401

Unable to locate credentials.

application/json

detail

string required

402

Out of free quota.

application/json

detail

string required

403

Credentials found, but not matching.

application/json

detail

string required

422

Validation Error

application/json

detail

object[]

Show 5 propertiesHide 5 properties

detail. loc

any[] required

detail. msg

string required

detail. type

string required

detail. input

any

detail. ctx

object

429

Rate limit reached

application/json

detail

string required

cURL

JavaScript

Python

        curl -L 'https://api.woosmap.com/distance/distancematrix/json?origins=48.709%2C2.403&destinations=48.709%2C2.303%7C48.768%2C2.338&mode=driving&language=en&elements=duration_distance&method=distance&key=YOUR_PUBLIC_API_KEY' \
-H 'Referer: http://localhost'

    

        const requestOptions = {
  method: "GET",
  redirect: "follow"
};

fetch("https://api.woosmap.com/distance/distancematrix/json?origins=48.709%2C2.403&destinations=48.709%2C2.303%7C48.768%2C2.338&mode=driving&language=en&elements=duration_distance&method=distance&key=YOUR_PUBLIC_API_KEY", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

    

        import requests

url = "https://api.woosmap.com/distance/distancematrix/json?origins=48.709%2C2.403&destinations=48.709%2C2.303%7C48.768%2C2.338&mode=driving&language=en&elements=duration_distance&method=distance&key=YOUR_PUBLIC_API_KEY"

payload = {}
headers = {
    'Referer': 'http://localhost'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)


    

200

        
{
  "status": "OK",
  "rows": [
    {
      "elements": [
        {
          "status": "OK",
          "duration": {
            "value": 978,
            "text": "16 mins"
          },
          "distance": {
            "value": 10796,
            "text": "10.8 km"
          }
        },
        {
          "status": "OK",
          "duration": {
            "value": 942,
            "text": "16 mins"
          },
          "distance": {
            "value": 10322,
            "text": "10.3 km"
          }
        }
      ]
    }
  ]
}

    

Was this helpful?

Failed to send feedback. Please try again.

Thanks for your feedback!