{"uid":"cap_gzR7drIKw2KCh2uoPF9uF","slug":"mapbox-map-matching-via-locus-x402-09496fe7","name":"Mapbox Map Matching via Locus x402","description":"Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.","url":"https://mapbox.x402.paywithlocus.com/mapbox/map-matching","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tidy":{"type":"boolean"},"steps":{"type":"boolean"},"profile":{"type":"string"},"overview":{"type":"string"},"radiuses":{"type":"string"},"geometries":{"type":"string"},"timestamps":{"type":"string"},"annotations":{"type":"string"},"coordinates":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E6ag_14RKeR0KNmK_L0oS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Snaps a sequence of GPS coordinates to the road network, returning a corrected route geometry with optional turn-by-turn instructions and travel annotations.","exampleAgentPrompt":"Take these GPS coordinates from my drive — -122.4194,37.7749;-122.4183,37.7758;-122.4172,37.7767 — and snap them to the road network using the mapbox/driving profile with full geometry detail and distance and duration annotations.","exampleUseCases":[{"title":"Fleet vehicle GPS trace correction","prompt":"I have a sequence of 20 GPS pings from one of our delivery trucks: -87.6298,41.8781;-87.6287,41.8790;-87.6276,41.8799 and so on — can you snap them all to the road network using the driving profile and give me full geometry with speed and congestion annotations?"},{"title":"Cycling route reconstruction from breadcrumbs","prompt":"I recorded a bike ride with these GPS coordinates: -122.4194,37.7749;-122.4180,37.7762;-122.4165,37.7775 — map-match them to the cycling road network with simplified geometry and include turn-by-turn steps so I can replay the route accurately."},{"title":"Running app track cleanup","prompt":"My running app logged some messy GPS points that cut through buildings — here are the coordinates: -73.9857,40.7484;-73.9845,40.7492;-73.9833,40.7501 — please snap them to the walking road network with a 20-meter search radius per point and return the corrected path as GeoJSON."}],"resultDescription":"Returns a JSON object containing the matched route geometry (in the requested format — GeoJSON, polyline, or polyline6), optional turn-by-turn step instructions, and per-segment annotations (distance, duration, speed, congestion, maxspeed). Also includes payment settlement details showing USDC charged and a request ID for status tracking.","failureModes":["Coordinates too far from any road (outside radius) — matching fails or returns no match","More than 100 coordinates submitted — exceeds API limit","Invalid routing profile string — returns error","Radiuses array length doesn't match coordinate count — parameter mismatch error","Timestamps out of order — chronological constraint violation","Payment failure or insufficient USDC balance — 402 response"],"whenToPreferThis":"Choose this endpoint when you have a raw GPS trace (from a vehicle, phone, or wearable) that needs to be corrected to actual road geometry. It is specifically for map matching — snapping noisy or imprecise GPS breadcrumbs to the road network — rather than computing a new route between origin and destination. Prefer this over directions endpoints when you already have recorded coordinates and need to clean or enrich them.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:32.896Z","isFirstParty":false}