Nominatim s'appuie sur les données OpenStreetMap et constitue depuis longtemps un choix par défaut pour les équipes qui voulaient une solution de géocodage sans licence commerciale. Les politiques d'utilisation d'une instance publique partagée peuvent rendre cet arrangement moins fiable à mesure que le trafic augmente, et c'est là qu'un hôte compatible qui gère les quotas devient utile.
Notre hôte compatible Nominatim reproduit à l'identique les paramètres de requête et le corps de réponse du service d'origine, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont ceux de My Geocode. Les requêtes construites au format Nominatim peuvent être envoyées sans modification à notre hôte, et la réponse est renvoyée dans la structure qu'attend déjà le code d'analyse existant.
L'authentification suit ici aussi nos quatre méthodes 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. Comme l'instance publique de Nominatim n'exige généralement aucune clé, en ajouter une ici signifie aussi bénéficier d'un quota dédié et traçable au lieu de partager une ressource publique non gérée.
Les tarifs sont les mêmes que sur tous nos autres hôtes et endpoints. 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 en plus. Au-delà de ces deux quotas, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois.
Une instance publique partagée doit se protéger par des politiques d'utilisation forcément prudentes, puisqu'elle ne peut pas distinguer à l'avance le trafic d'un appelant de celui d'un autre. Une clé change la donne : l'utilisation d'un compte est décomptée de son propre quota, quoi qu'il se passe par ailleurs sur le service ce jour-là, ce qui constitue une garantie différente de celle qu'une ressource partagée peut offrir, aussi généreuse que soit sa politique affichée.
Les en-têtes de quota sont joints à chaque réponse de cet hôte, ce qui change nettement d'une instance publique partagée sans visibilité par appelant : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining sont tous inclus, afin que vous sachiez toujours exactement où vous en êtes au lieu de deviner une politique d'utilisation non publiée.
Pour les projets qui veulent plus que ce que renvoie par défaut la réponse compatible, ajouter mg_extras=1 à la requête, ou un en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs par-dessus, sans modifier la structure de base sauf si vous le demandez.
Si vous ne savez pas comment un changement se comportera dans un pays ou une région donnés, la page de couverture sur /coverage/ indique en détail où les données de géocodage sont disponibles, ce qui constitue un bon premier arrêt avant de diriger le trafic de production vers un nouvel hôte, au format Nominatim ou non.
L'hôte est documenté sur /compatibility/nominatim/, et des conseils généraux pour changer de fournisseur se trouvent sur /docs/compatibility/. Pour ceux qui dépendent aujourd'hui d'une instance publique de Nominatim, cela offre la même structure de requête avec un quota dédié et des en-têtes de quota clairs.