Introduction

Welcome to the Travelyzer Places API documentation. This RESTful API allows you to convert addresses into geographic coordinates and vice versa, with professional-grade accuracy and reliability.

What is Geocoding?

Geocoding is the process of converting an address or place name into geographic coordinates (latitude and longitude). It's an essential feature for many modern applications.

Forward Geocoding

Convert a text address into coordinates:

"Eiffel Tower, Paris" → { lat: 48.8584, lon: 2.2945 }

Reverse Geocoding

Convert coordinates into a readable address:

{ lat: 48.8584, lon: 2.2945 } → "Eiffel Tower, Avenue Anatole France, 75007 Paris, France"

Why Travelyzer Places API?

Reliability

• 99.9% uptime guaranteed by SLA
• Distributed and redundant infrastructure
• Publicly accessible real-time monitoring

Performance

• Average response time under 100ms
• Smart caching for instant results
• Optimized autocomplete for real-time use

Simplicity

• Standard REST API, easy to integrate
• Secure JWT authentication
• Complete documentation with examples

Worldwide Coverage

• Data available in all countries
• Regular updates to mapping data
• Multi-language support for results

Features

Available Endpoints

Returned Data

Each geocoding result includes:

Monitoring and SLA

Access performance metrics at any time:

Use Cases

Travel and Transportation Apps

• Quick destination identification (countries, cities, places)
• City and region search for itineraries
• Display places on an interactive map

E-commerce and Logistics

• Delivery address validation and normalization
• Delivery zone calculation
• Pickup point geolocation

Forms and Address Input

• Smart address field autocomplete
• Reduction of user input errors
• Improved user experience

Mobile Applications

• Nearby place search
• Navigation and routes
• Reverse geolocation (where am I?)

Data Analysis

• Customer database geocoding
• Data enrichment with coordinates
• Geographic visualization

LLM and AI Agent Integration

• Provide quick geographic context to language models
• Identify locations mentioned by users
• Resolve geographic ambiguities (Paris, France vs Paris, Texas)

What This API is NOT

The API is NOT designed for:

• Searching for hotels, restaurants, or businesses
• Finding precise addresses with street numbers
• Serving as a detailed POI (Points of Interest) database
• Real estate or cadastral searches

The API IS designed for:

• Quickly identifying countries, cities, and places
• Providing geographic context to LLMs and AI agents
• Quick searches without dwelling on details
• Applications requiring fast localization, not millimeter precision

Simplified Architecture

┌─────────────────┐         ┌──────────────────────┐
│                 │         │                      │
│    Your App     │────────▶│  Travelyzer Places   │
│                 │◀────────│        API           │
│                 │         │                      │
└─────────────────┘         └──────────────────────┘
        │                            │
        │  1. Get a JWT token        │
        │  2. Call the API           │
        │  3. Receive results        │
        └────────────────────────────┘

Integration Flow

1. Create your credentials in the Developer Dashboard
2. Get a JWT token via the /api-clients/token endpoint
3. Call the API with your token in the Authorization header
4. Receive results in JSON format

Pricing

Next Steps