Démarrage rapide
Créez votre compte, générez une clé API, autorisez vos domaines et lancez votre première requête en moins de 5 minutes.
Cette page résume les trois étapes pour passer de zéro à votre premier appel API. Chaque étape est détaillée dans sa propre page : suivez les liens pour aller en profondeur.
1. Créer un compte sur la console
Rendez-vous sur app.tmaps.tn et créez un compte avec votre email + mot de passe ou en un clic via Google.
→ Détails : Créer un compte
2. Créer une clé API et autoriser vos domaines
Une fois connecté à la console :
- Ouvrez la section API Keys et cliquez sur Create API Key — vous obtenez une clé au format
ak_…. - Ouvrez la section Authorized Domains et ajoutez les domaines depuis lesquels votre clé sera utilisée
(ex :
monsite.tn,app.monsite.tn). - Liez la clé à un ou plusieurs domaines depuis l’écran de la clé.
Pas de wildcard
Le check des domaines est strict. *.monsite.tn n’est pas accepté : ajoutez chaque sous-domaine
explicitement. localhost doit également être ajouté pour le développement local.
→ Détails : Gérer les clés API · Domaines autorisés
3. Lancer votre première requête
Toutes les requêtes utilisent un paramètre api_key en query string :
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"Côté serveur, aucun domaine requis
Si vous appelez l’API depuis un backend Node, PHP, Python… (sans header Origin ni Referer),
votre clé fonctionne sans restriction de domaine. Les domaines autorisés ne s’appliquent qu’aux
appels initiés depuis un navigateur.
Et après ?
Selon votre cas d’usage, plongez dans la référence d’API correspondante :
- Afficher une carte : Tuiles raster ou Tuiles vectorielles
- Convertir des adresses : Géocodage direct / inverse
- Trouver des points d’intérêt : Recherche à proximité
- Calculer un itinéraire : Direction · Optimisé · Isochrone
- Comparer des temps de trajet : Matrice de distances
- Générer une image de carte : Cartes statiques