Matrices

Travel time and distance between many points

Generated from OpenAPI
POST
/matrix

Computes distances and durations between every source and every target. Useful for dispatch, nearest-driver selection and delivery clustering.

Cost: 1 credit per 10 elements, where elements = sources × targets. The cost driver is elements, not calls.

Authorization

apiKey
headerAuthorizationBearer <token>

Send your key as Authorization: Bearer sk_live_….

Secret keys (sk_) are for server-side use and must never be exposed in a browser or a mobile binary. Browser or mobile use of secret keys is unsupported. Use your server to call these endpoints.

Request Body

application/json
  1. body
sources*array<array<any>>

Origins.

Items1 <= items <= 100
targets*array<array<any>>

Destinations.

Items1 <= items <= 100
profile?Profile

The vehicle and behaviour model used for costing. moto is the motorcycle-taxi profile and the one most Rwandan traffic actually uses.

Default"car"
Example"moto"
Value in"moto""car""truck""bicycle""pedestrian""pedestrian_loaded"
departure_time?string

Departure time, applied to every element.

Formatdate-time
Example"2026-09-02T07:15:00+02:00"

Response Body

The matrix was computed.

application/json
  1. response

Fields present on every successful response.

request_id*string

Unique id for this request. Quote it in any support conversation.

Lengthlength <= 64
Example"req_01JBQ7Z9Y4K2M3N4P5Q6R7S8T9"
credits_charged*integer

Credits deducted from the account balance for this request.

Range0 <= value
Example1
data_version*string

The data release that answered this request.

Lengthlength <= 32
Example"2026-09-02T03"
profile*Profile

The vehicle and behaviour model used for costing. moto is the motorcycle-taxi profile and the one most Rwandan traffic actually uses.

Default"car"
Example"moto"
Value in"moto""car""truck""bicycle""pedestrian""pedestrian_loaded"
durations*array<array<|>>

Durations in seconds, indexed [source][target]. A null element means that pair is unroutable.

Itemsitems <= 100
distances*array<array<|>>

Distances in metres, indexed [source][target].

Itemsitems <= 100
curl -X POST 'https://api.uat.audisory.com/v1/matrix' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Content-Type: application/json' \  -d '{  "sources": [    [      30.0619,      -1.9441    ],    [      30.108,      -1.954    ],    [      30.043,      -1.939    ]  ],  "targets": [    [      30.122,      -1.942    ]  ],  "profile": "moto"}'
{  "request_id": "req_01JBQ7Z9Y4K2M3N4P5Q6R7S8TA",  "credits_charged": 1,  "data_version": "2026-09-02T03",  "profile": "moto",  "durations": [    [      1180    ],    [      620    ],    [      1450    ]  ],  "distances": [    [      9200    ],    [      4800    ],    [      11300    ]  ]}

Try this API in your console playground →