OpenCage

Turn addresses into coordinates and coordinates into answers

When a customer provides an address or GPS coordinates, your AI agent instantly resolves it through OpenCage's geocoding API. Forward geocoding converts addresses to map coordinates. Reverse geocoding turns latitude and longitude into readable locations. Location-aware conversations become the default, not the exception.

Chosen by 800+ global brands across industries

Location intelligence in every interaction

Your AI agent resolves addresses to coordinates and coordinates to addresses in real-time, enriching conversations with timezone data, country codes, and geographic context from OpenCage.

Forward Geocode

A customer types their street address. Your AI agent sends it to OpenCage and receives precise latitude and longitude coordinates, along with confidence scores and formatted address components. Service area validation happens automatically during the chat.

Reverse Geocode

A delivery driver shares GPS coordinates from their phone. The agent converts those coordinates into a human-readable address using OpenCage's reverse geocoding, showing the street name, city, state, and postal code. Dispatchers get clarity without juggling map apps.

Retrieve GeoJSON Data

The agent requests geocoding results in GeoJSON format, ready for direct use in mapping applications and spatial databases. Location data from customer conversations flows directly into your geographic information systems without format conversion.

Filter by Country

Operating in specific markets? The agent restricts geocoding results to one or more countries using ISO country codes. When a UK customer types an ambiguous place name, results are filtered to the UK, avoiding confusion with similarly named locations elsewhere.

Enrich with Timezone Data

Beyond coordinates, OpenCage returns timezone information, currency details, and FIPS codes for each location. The agent uses this enrichment to schedule deliveries in the customer's local time or display prices in their local currency during the conversation.

Proximity-Biased Search

When a customer searches for a nearby location, the agent passes a proximity point to bias results toward their area. A customer in San Francisco asking for the nearest office gets results centered around their location rather than matches from across the country.

OpenCage

Use Cases

Geocoding that powers real decisions

See how businesses embed location intelligence into AI conversations for service area validation, delivery routing, and customer location enrichment.

Service Area Validation at First Contact

A potential customer asks if you deliver to their address. Your AI Agent geocodes their address through OpenCage, gets the coordinates, and checks them against your service area boundaries. If they are within range, the agent proceeds to take their order. If not, it suggests the nearest serviced location or offers alternative shipping options. No wasted time for either party.

Real-Time Delivery Location Resolution

A delivery customer shares their current location as GPS coordinates from their mobile device. Your AI Agent reverse-geocodes the coordinates through OpenCage to display the full street address, cross-references it with the delivery order address, and confirms whether the driver is at the right location. Address ambiguity resolves in one message.

Timezone-Aware Appointment Scheduling

An international customer wants to schedule a call with your team. Your AI Agent geocodes their city through OpenCage, extracts the timezone information from the response, and presents available time slots converted to the customer's local time. No more confusion about AM versus PM across time zones, and no double-booked calls due to conversion errors.

Try
OpenCage

OpenCage

FAQs

Frequently Asked Questions

What data does OpenCage return beyond just coordinates?

OpenCage returns structured address components, confidence scores from 0 to 10, timezone information, currency details, FIPS codes, NUTS codes, UN/LOCODE identifiers, what3words addresses, Wikidata IDs, and speed limits when available. The agent can use any of these enrichment fields to provide more context during conversations.

How accurate is the geocoding for different types of addresses?

Accuracy depends on the input quality and region. OpenCage aggregates data from OpenStreetMap, GeoNames, and other open sources. Each result includes a confidence score from 1 to 10 that indicates reliability. The agent can filter results by minimum confidence to ensure only high-quality matches are used in business-critical conversations.

What authentication does Tars need for OpenCage?

Tars requires your OpenCage API key, which you get when you create an OpenCage account. Free accounts provide 2,500 requests per day. Paid plans offer higher limits and faster rate limits. The key is entered once in the Tars dashboard and can be regenerated anytime from your OpenCage account.

Does Tars store geocoded location data?

No. Geocoding results are fetched live from OpenCage during each conversation and used only for that interaction. OpenCage's licensing allows you to store results permanently if needed, but Tars itself does not cache or maintain a database of geocoded locations.

Which countries and regions does OpenCage cover?

OpenCage provides worldwide geocoding coverage using open data sources including OpenStreetMap, which covers virtually every country. Coverage quality varies by region, with major cities and developed areas having the most detailed data. The countrycode parameter lets you restrict results to specific countries for targeted markets.

How is this different from using Google Maps geocoding?

OpenCage uses open data sources and offers transparent, predictable pricing without surge charges. Unlike Google Maps, you can permanently store geocoded data. OpenCage also provides unique enrichments like what3words, NUTS codes, and UN/LOCODE identifiers. For businesses concerned about vendor lock-in or data licensing, OpenCage offers more flexibility.

Can the agent geocode in multiple languages?

Yes. The language parameter accepts ISO 639-1 codes, and results are returned in the specified language when translations are available. This is especially useful for international businesses where customers input addresses in their local language but results need to be displayed in a different language.

What happens if OpenCage cannot find a match for an address?

If no results are returned, the agent asks the customer to provide more details, check for typos, or try a nearby landmark. It can also broaden the search by removing filters or lowering the minimum confidence threshold. The conversation continues smoothly without dead ends.

How to add Tools to your AI Agent

Supercharge your AI Agent with Tool Integrations

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

We’ll never let you lose sleep over privacy and security concerns

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

GDPR
ISO
SOC 2
HIPAA

Still scrolling? We both know you're interested.

Let's chat about AI Agents the old-fashioned way. Get a demo tailored to your requirements.

Schedule a Demo