Toutes les questions de localisation ne sont pas vraiment des questions de géocodage. Parfois, la seule chose dont une application a besoin est le code postal d'une zone donnée, ou la zone couverte par un code postal donné, sans la résolution d'adresse plus large qu'offre le géocodage direct ou inverse. /v1/postcode existe précisément pour cette question plus ciblée, en tant qu'endpoint dédié plutôt que comme effet secondaire d'une recherche plus générale.
Le garder séparé de /v1/forward et /v1/reverse compte pour plusieurs raisons pratiques. Le format de requête peut ainsi être construit spécifiquement autour des paramètres de code postal plutôt qu'adapté d'une structure d'adresse plus large. La réponse peut se concentrer exactement sur ce dont une intégration limitée aux codes postaux a besoin, sans champs d'adresse superflus à filtrer. Et la documentation, disponible en intégralité sur /docs/postal-code-lookup/, peut expliquer le comportement des codes postaux pour lui-même plutôt que comme une sous-section d'un guide de géocodage plus long.
L'authentification suit les mêmes règles que pour tous les autres endpoints : 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, tous acceptés de manière identique. La tarification est également la même : le même quota quotidien gratuit, qu'il provienne du réseau appelant ou de la clé, puis les mêmes 0,0001 € par requête en crédit prépayé ou la couverture d'un forfait Unlimited au-delà.
Les requêtes groupées fonctionnent ici exactement comme partout ailleurs sur la plateforme : chaque code postal ou adresse soumis dans un même appel compte pour une requête, et non l'appel dans son ensemble. Une équipe qui valide les codes postaux d'une grande liste de clients peut envoyer cette liste en lot et bénéficier du même décompte par élément que pour toute autre opération groupée sur My Geocode.
Disposer d'un endpoint dédié rend aussi plus précise la compatibilité des codes postaux sur nos dix-sept hôtes compatibles, car les fournisseurs qui proposent leur propre recherche postale dédiée peuvent être reproduits exactement plutôt qu'approximés via un format de géocodage plus large.
Si votre application n'a besoin que des informations de code postal et envoyait jusqu'ici des requêtes de géocodage plus larges uniquement pour en extraire ce champ, il vaut la peine de passer directement à /v1/postcode. Il est entièrement documenté sur /docs/postal-code-lookup/, avec le reste de notre référence des endpoints sur /docs/.