Remplacement compatible de TomTom Search

Les endpoints Geocode, Reverse Geocode et Fuzzy Search de TomTom répondent sur tomtom.mygeocode.com avec la même structure summary et results, y compris le champ freeformAddress que la plupart des intégrations affichent.

Changez un seul nom d'hôte

Hôte d'origine	`api.tomtom.com`
À utiliser à la place	`tomtom.mygeocode.com`
Paramètre de clé	`key` (facultatif : toute adresse dispose de 2 500 requêtes par jour sans clé ; mettez ici votre clé My Geocode pour le crédit, les forfaits et un historique d'utilisation)

Avant

curl "https://api.tomtom.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_TOMTOM_KEY"

Après

curl "https://tomtom.mygeocode.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_MYGEOCODE_KEY"

Pourquoi changer

L'offre gratuite de TomTom est de 2 500 transactions par jour, comme la nôtre, mais une transaction peut y coûter plusieurs crédits. Ici, chaque appel correspond à une requête, et l'usage payant propose une option forfaitaire.

Le même quota gratuit, avec ou sans clé. Les requêtes vers tomtom.mygeocode.com sont décomptées des mêmes 2 500 requêtes gratuites par jour dont votre adresse, ou votre clé, dispose sur nos propres endpoints. Au-delà, crédit prépayé à 0,0001 € par requête, ou 50 € par mois pour une clé Unlimited. L'inscription ne demande qu'une adresse e-mail, rien d'autre.

Voir les tarifs Obtenir une clé gratuite

Endpoints

Chemin sur tomtom.mygeocode.com	Rôle	Fourni par
`/search/2/geocode/{query}.json`	Géocodage	Géocodage direct
`/search/2/structuredGeocode.json?countryCode=...&streetName=...`	Géocodage structuré	Géocodage direct
`/search/2/reverseGeocode/{lat},{lon}.json`	Géocodage inverse	Géocodage inverse
`/search/2/search/{query}.json?typeahead=true`	Recherche approximative avec saisie anticipée	Saisie semi-automatique d'adresses

Exemple de réponse

Voici ce que renvoie la requête ci-dessus. Les noms de champs, l'imbrication et les types suivent TomTom. Seules les données qu'ils contiennent sont les nôtres.

Réponse de tomtom.mygeocode.com

{
  "summary": {
    "query": "avenida paulista 1578 sao paulo",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 1,
    "offset": 0,
    "totalResults": 1,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "Point Address",
      "id": "mg.br.addr.7d1a55f2",
      "score": 11.98,
      "address": {
        "streetNumber": "1578",
        "streetName": "Avenida Paulista",
        "municipalitySubdivision": "Bela Vista",
        "municipality": "São Paulo",
        "countrySecondarySubdivision": "São Paulo",
        "countrySubdivision": "São Paulo",
        "countrySubdivisionCode": "SP",
        "postalCode": "01310-200",
        "countryCode": "BR",
        "country": "Brasil",
        "countryCodeISO3": "BRA",
        "freeformAddress": "Avenida Paulista 1578, Bela Vista, São Paulo, SP 01310-200",
        "localName": "São Paulo"
      },
      "position": { "lat": -23.561414, "lon": -46.655881 },
      "viewport": {
        "topLeftPoint": { "lat": -23.560514, "lon": -46.656881 },
        "btmRightPoint": { "lat": -23.562314, "lon": -46.654881 }
      }
    }
  ]
}

Détails et différences

Aucune clé n'est nécessaire pour les 2 500 premières requêtes de la journée. Pour utiliser une clé My Geocode, placez-la là où se trouvait votre clé TomTom : le paramètre de requête key. L'en-tête X-API-Key, Authorization: Bearer et l'authentification HTTP Basic (la clé comme nom d'utilisateur) fonctionnent aussi sur tous les hôtes, de sorte que les bibliothèques clientes qui s'authentifient à leur manière continuent de fonctionner sans modification.

Le géocodage en texte libre, structuré et inverse sont tous routés, ainsi que l'endpoint search.
Les réponses conservent la structure summary et results de TomTom.
Batch Search fonctionne dans les deux modes. POST /search/2/batch/sync.json traite jusqu'à 100 batchItems à la fois dans la structure de TomTom (statusCode et response par élément, summary). POST /search/2/batch.json accepte jusqu'à 10 000 éléments, renvoie 202 avec un en-tête Location, et le résultat se récupère à cette adresse. Chaque élément du lot compte pour une requête, comme TomTom les compte ; un lot plus grand que ce qui reste du quota est refusé en entier avec le 429 de TomTom, et la récupération d'un résultat stocké ne compte rien.

Si votre client dépend d'un champ ou d'un comportement qui ne figure pas ici, dites-le-nous. Les écarts de compatibilité sont corrigés rapidement, car ils sont généralement minimes.

Autres hôtes compatibles

Fonctionnement des hôtes compatibles, la vue d'ensemble et les remplacements compatibles pour bibliothèques JavaScript.