Les logiciels de navigation et de logistique intègrent souvent TomTom Search à un niveau assez profond, car les recherches d'adresses y côtoient généralement des appels d'itinéraire et de cartographie développés par la même équipe, dans le même style. Migrer un élément sans toucher au reste est exactement ce que notre hôte compatible est conçu pour rendre possible.
Il reproduit à l'identique les paramètres de requête et le corps de réponse de TomTom Search, la seule différence étant les textes de copyright, de conditions et de confidentialité, qui concernent My Geocode et non le fournisseur d'origine. Partout où votre code envoie aujourd'hui une requête de géocodage au format TomTom, il peut envoyer cette même requête à notre hôte, et la réponse s'analyse de la même façon sans rien changer à votre logique existante.
Les appels d'itinéraire et de cartographie développés par la même équipe partagent souvent des conventions : la même logique de nouvelle tentative, la même gestion des erreurs, les mêmes attentes en matière de délais. Reproduire exactement la structure de requête et de réponse de TomTom Search, plutôt que de proposer une API de géocodage similaire mais différente, signifie que cette logique environnante n'a pas besoin d'être testée à nouveau simplement parce qu'un appel au milieu pointe désormais ailleurs.
L'authentification repose sur nos quatre options habituelles : un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic avec la clé comme nom d'utilisateur, ou un paramètre de requête. La méthode sur laquelle s'appuie déjà votre intégration TomTom actuelle est acceptée ici aussi, sans modification.
Les tarifs sont identiques à ceux de tous les autres hôtes et endpoints de la plateforme. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans clé, comptées par réseau. Une clé ajoute ses propres 2 500 requêtes gratuites par jour supplémentaires. Au-delà de ces deux quotas, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre l'utilisation pour 50 € par mois, sans frais supplémentaires pour l'utilisation d'un hôte compatible plutôt que d'un endpoint natif.
Les équipes qui exploitent des logiciels de navigation ou de logistique répartissent souvent leur trafic sur plusieurs clés, une par environnement ou une par service interne, afin qu'un problème en préproduction n'entame jamais le quota de production. La page des clés du tableau de bord, sur /dashboard/keys, permet de générer et de nommer des clés supplémentaires de la même façon pour une intégration au format TomTom que pour n'importe quelle autre.
Les en-têtes de quota sont joints à chaque réponse de cet hôte aussi : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining sont tous présents, offrant un niveau de visibilité sur l'utilisation qu'une intégration TomTom directe ne fournirait pas autrement.
Si un projet veut plus que la réponse compatible standard, ajouter mg_extras=1 à la requête, ou envoyer un en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs par-dessus, uniquement si vous le choisissez, en laissant la structure de réponse de base intacte tant que vous ne demandez pas expressément davantage.
L'hôte est documenté sur /compatibility/tomtom/, et des conseils généraux de migration pour les hôtes compatibles de la plateforme se trouvent sur /docs/compatibility/. Rediriger ici une intégration existante au format TomTom demande un nom d'hôte modifié et une nouvelle clé, rien d'autre.