{"uid":"cap_KliGRPBVSf_pxYBpcenq4","slug":"mapbox-map-matching-7bf8d151","name":"Mapbox Map Matching","description":"Snap GPS traces to the road network. Corrects noisy GPS data into clean routes.","url":"https://mapbox.mpp.paywithlocus.com/mapbox/map-matching?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["profile","coordinates"],"properties":{"tidy":{"type":"boolean","description":"Clean up coordinate clusters for better matching"},"steps":{"type":"boolean","description":"Include turn-by-turn instructions"},"profile":{"type":"string","description":"Routing profile: mapbox/driving, mapbox/driving-traffic, mapbox/walking, mapbox/cycling"},"overview":{"type":"string","description":"Geometry detail: full, simplified, false"},"radiuses":{"type":"string","description":"Semicolon-separated search radius per coordinate (0-50 meters)"},"geometries":{"type":"string","description":"Response format: geojson, polyline, polyline6"},"timestamps":{"type":"string","description":"Semicolon-separated Unix timestamps per coordinate"},"annotations":{"type":"string","description":"Comma-separated: distance, duration, speed, congestion, maxspeed"},"coordinates":{"type":"string","description":"Semicolon-separated lon,lat pairs (2-100 coordinates)"}},"additionalProperties":true},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["maps","geocoding","directions","routing","geospatial","data"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZNR72fdp0-oaaeImyU40I","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Mapbox","brandSlug":"mapbox","brandBaseUrl":"https://www.mapbox.com","brandDocsUrl":"https://docs.mapbox.com/api/","whatItDoes":"Snaps noisy GPS traces or raw coordinates to the most likely roads on a map using Mapbox routing profiles","exampleAgentPrompt":"Take these GPS coordinates from my drive and snap them to the actual roads using the mapbox/driving profile: -122.4194,37.7749; -122.4180,37.7760; -122.4165,37.7775 — give me the full geometry with turn-by-turn steps and distance annotations.","exampleUseCases":[{"title":"Correct delivery driver GPS drift","prompt":"I have a series of GPS points recorded from one of our delivery drivers today, but the trace is all over the place due to signal issues. Can you snap these coordinates to the actual roads using the driving profile and give me a clean route geometry I can display on a map? Here are the points: -87.6298,41.8781; -87.6285,41.8790; -87.6271,41.8802; -87.6258,41.8815"},{"title":"Visualize cycling workout on map","prompt":"I just finished a bike ride and exported the raw GPS track from my fitness tracker, but it cuts through buildings and parks instead of following the roads and bike paths. Please match these coordinates to actual cycling routes and give me back the corrected path with distance and duration for each segment: -122.2712,37.8044; -122.2698,37.8055; -122.2681,37.8067; -122.2665,37.8079"},{"title":"Analyze fleet trip for road segments","prompt":"We recorded a vehicle's GPS trace during a long haul and need to analyze which specific road segments it traveled, including congestion and speed data for each. Can you take these raw coordinates and snap them to the road network using the driving profile, then return annotations for speed and congestion along the matched route? The points are: -73.9857,40.7484; -73.9842,40.7495; -73.9826,40.7508; -73.9811,40.7521"}],"resultDescription":"Returns a road-snapped route geometry (as GeoJSON, polyline, or polyline6) with matched waypoints, optional turn-by-turn navigation steps, and annotations such as distance, duration, speed, or congestion for each segment along the corrected path.","failureModes":["Coordinates too far from any road (>50m radius) — no match found","Fewer than 2 or more than 100 coordinates provided — validation error","Invalid routing profile string — bad request","Timestamps not monotonically increasing — matching error","Coordinates not semicolon-separated in correct lon,lat format — parse error"],"whenToPreferThis":"Use this endpoint when you have raw GPS traces or sequences of coordinates that need to be aligned to actual road or path networks — e.g. correcting GPS drift from a vehicle tracker, visualizing a recorded trip on a map, or preparing navigation data for analysis. Prefer this over the Directions endpoint when you have observed position data rather than origin/destination pairs you want to route between.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:32:14.025Z","isFirstParty":false,"canonicalSlug":"mapbox-map-matching-7bf8d151"}