
Mapbox
Your AI agent geocodes addresses, calculates driving directions, computes travel time matrices, and retrieves map data, all from Mapbox during live conversations. Customers asking 'How do I get to your nearest location?' receive turn-by-turn directions in seconds, not a link to figure it out themselves.




Your AI agent transforms Mapbox's geocoding, navigation, and mapping APIs into location answers customers can act on immediately.
Mapbox
How businesses use AI agents with Mapbox to give customers precise location, routing, and distance information without leaving the chat.
A customer asks 'Where is your closest store to me?' and shares their location. Your AI Agent geocodes their position, computes distances to all your retail locations using Mapbox's Matrix API, identifies the nearest one, and provides turn-by-turn driving directions with an estimated arrival time. The customer gets actionable directions. Your team handles zero 'find a store' support requests.
A customer asks when their order will arrive. Your AI Agent takes the warehouse address and the customer's delivery address, calls Mapbox's Directions API with the driving-traffic profile, and returns a travel time that accounts for current road conditions. The customer gets a realistic ETA. Your dispatch team avoids over-promising delivery windows.
A customer provides their shipping address during a purchase conversation. Your AI Agent geocodes the address through Mapbox and confirms it resolves to a valid, routable location. If the address is ambiguous, the agent presents matching suggestions. Delivery errors from bad addresses drop because every address is validated before the order ships.

Mapbox
FAQs
The agent uses Mapbox's Forward Geocoding API. It sends the address text and receives geographic coordinates along with structured place data. Mapbox supports free-form queries like 'Times Square NYC' and structured components like street, city, and postal code. Fuzzy matching catches typos automatically.
Yes. Mapbox's Directions API supports four routing profiles: driving (standard), driving-traffic (accounts for live conditions), walking, and cycling. The agent selects the appropriate profile based on conversation context and returns step-by-step instructions with duration estimates.
No. Tars sends geocoding and routing requests to Mapbox in real time and uses results within the active conversation only. Customer addresses and coordinates are not stored in a separate database. Mapbox's temporary geocoding (non-permanent) mode is used by default.
The Matrix API computes travel times and distances between multiple origins and destinations simultaneously. Your agent uses it when comparing distances to multiple store locations, optimizing delivery routes, or answering questions like 'Which of your three offices is closest to me?' It handles up to 25 coordinate pairs per request.
Yes. Mapbox's Batch Geocoding endpoint processes up to 50 forward or reverse geocoding queries in a single call. The agent can validate a list of delivery addresses, geocode event attendee locations, or convert multiple GPS coordinates to addresses efficiently.
A maps link takes customers away from your conversation. The Tars agent calculates routes and provides directions directly in chat, keeping customers engaged. It also enables programmatic decisions like nearest-location routing, travel time comparisons, and address validation that a simple map link cannot provide.
Yes. All geocoding endpoints accept country code filters (ISO 3166 alpha-2) and IETF language tags. The agent can restrict results to specific countries and return place names in the customer's preferred language. Useful for multi-region businesses with location-specific services.
A standard Mapbox public token with geocoding and directions scopes is sufficient for most use cases. If you use the permanent geocoding endpoints for data storage, you need a secret token with permanent geocoding enabled. Token management happens in your Mapbox account dashboard.
Don't limit your AI Agent to basic conversations. Watch how to configure and add powerful tools making your agent smarter and more functional.

Privacy & Security
At Tars, we take privacy and security very seriously. We are compliant with GDPR, ISO, SOC 2, and HIPAA.