TMaps - Mapping API Tunisia

Getting started

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

This page walks you through the three steps to go from zero to your first API call. Each step has a dedicated page — follow the links for the full details.

1. Create an account on the console

Head to app.tmaps.tn and sign up with email + password or in one click via Google.

→ Details: Create an account

2. Create an API key and allow your domains

Once logged into the console:

  1. Open the API Keys section and click Create API Key — you get a key in ak_… format.
  2. Open the Authorized Domains section and add the domains your key will be used from (e.g. mysite.tn, app.mysite.tn).
  3. Link the key to one or several domains from the key’s screen.

No wildcards

Domain checks are strict. *.mysite.tn is not accepted: add each subdomain explicitly. localhost must also be added for local development.

→ Details: Manage API keys · Authorized Domains

3. Run your first request

Every request uses an api_key parameter in the query string:

GET https://api.tmaps.tn/geocoding/forward?q=Avenue%20Habib%20Bourguiba%2C%20Tunis&api_key=YOUR_API_KEY 
curl "https://api.tmaps.tn/geocoding/forward?q=Avenue%20Habib%20Bourguiba%2C%20Tunis&api_key=YOUR_API_KEY"

Server-side: no domain required

When calling the API from a backend (Node, PHP, Python… without an Origin or Referer header), your key works without domain restriction. Authorized domains only apply to browser-initiated requests.

What’s next?

Depending on your use case, dive into the matching API reference: