TMaps documentation

Getting-started guides, API references and tutorials for the TMaps mapping, geocoding and routing services.

Welcome to the TMaps documentation. This section covers everything you need to integrate our services: create an account, manage API keys, secure your calls per domain, and use each endpoint with copy-pasteable code samples.

Where to start?

If this is your first integration, follow the quick start. If you're looking for a specific endpoint reference, use the sidebar.

Getting started

Create your account, generate an API key, allow your domains and run your first request in under 5 minutes.

Authentication

How to pass your API key, how authorized domains work and how to call the API from a server.

Raster tiles

PNG tiles ready to plug into Leaflet, MapLibre or OpenLayers. Worldwide coverage optimized for Tunisia.

Vector tiles

Four vector styles (streets, dark, terrain, sunny) consumable by MapLibre GL for ultra-fast maps.

Forward geocoding

Convert a free-text address into precise GPS coordinates with a confidence score and full breakdown (commune, delegation, governorate).

Directions

Compute the optimal route between two or more points, with turn-by-turn, distance and duration.

Manage API keys

Create, disable or revoke your API keys from the TMaps console.

Error codes

Full list of HTTP status codes and what they mean (400, 401, 403, 404, 429, 5xx).

Conventions

Authentication: every endpoint uses an api_key query-string parameter.
Format: all responses are JSON, UTF-8 encoded.
Coordinates: lat = latitude (–90 to 90), lng = longitude (–180 to 180), in WGS84 decimal degrees.
HTTPS only: HTTP requests return 403.