Mapbox Retrieve Matrix for Mapbox Tools | Aident Loadout

Mapbox Tools

Mapbox Retrieve Matrix

Retrieve a travel time and distance matrix between multiple locations. Use this tool when you need to calculate travel times and/or distances between many origin-destination pairs efficiently (e.g., comparing routes from multiple starting points to multiple destinations, finding…

Write ActionRisk level 2 of 5API key connectionFree Action

Use Mapbox Retrieve Matrix

Owner App

Mapbox ToolsApp

Required inputs

Product

Aident Loadout Aident Playbook Editor Open-CUAK

About

Apps Skills Docs Blog Pricing Downloads Privacy Policy Terms of Service

Alternatives

vs Composio vs Zapier

llms.txtGet an AI summary of Aident Loadout

profileRequiredstring

Transportation mode for routing: 'mapbox/driving' (car), 'mapbox/walking' (pedestrian), 'mapbox/cycling' (bicycle), or 'mapbox/driving-traffic' (car with live traffic, max 10 coords).

sourcesstring

Which coordinates to use as origins (starting points). Use 'all' (default) for all coordinates, or semicolon-separated 0-based indices (e.g., '0;2;4' for coords at index 0, 2, and 4).

bearingsstring

Semicolon-separated 'angle,deviation' pairs per waypoint; angle 0–360, deviation in degrees; skip with ';'.

depart_atstring

BETA: desired departure time in ISO 8601 format (e.g., YYYY-MM-DDThh:mm:ssZ).

approachesstring

Semicolon-separated list per waypoint: 'unrestricted' or 'curb'. Count must match number of coordinates; skip entries with ';'.

annotationsstring

Data to return in the matrix: 'duration' (travel time in seconds), 'distance' (travel distance in meters), or 'duration,distance' (both). Default: 'duration'.

coordinatesRequiredarray

List of 2-25 geographic points (longitude, latitude pairs). The API calculates travel times/distances between these points. Maximum 10 for 'mapbox/driving-traffic' profile.

access_tokenstring

Mapbox access token (optional; auto-provided by auth).

destinationsstring

Which coordinates to use as destinations (ending points). Use 'all' (default) for all coordinates, or semicolon-separated 0-based indices (e.g., '1;3;5' for coords at index 1, 3, and 5).

fallback_speedinteger

Speed in km/h for straight-line distance estimates when no routable path exists between points (e.g., across water). Must be > 0 if specified.

Observable output

dataRequired
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulRequiredboolean
Whether or not the action execution was successful or not

Setup and approval

API key connection. Risk level 2 of 5.

Pricing and limits

Free Action

Unified payment: Not currently supported

Skills that use this Action

No published Skills explicitly reference this Action yet.

Official source

Provider source