Surveillez l'utilisation de votre clé avant d'atteindre une limite
Surveiller vos en-têtes de quota au fil de l'eau vous indique quand une limite approche, bien avant qu'une requête ne soit effectivement refusée.
Trouver le code postal d'une adresse incomplète
Un client qui laisse vide le champ du code postal ne vous a pas forcément fourni de mauvaises données. Le géocodage direct peut généralement combler ce manque à partir du reste de l'adresse.
Envoyer l'adresse partielle
Envoyez le texte dont vous disposez, au minimum la rue et la ville, à /v1/forward. L'objet components du résultat inclut le code postal de la meilleure correspondance, même si la saisie n'en mentionnait aucun.
GET /v1/forward?q=1600 Pennsylvania Avenue, Washington&limit=1{
"status": "ok",
"query": "1600 Pennsylvania Avenue, Washington",
"results": [
{
"formatted": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
"lat": 38.8977,
"lon": -77.0365,
"type": "address",
"precision": "house",
"confidence": 0.97,
"place_id": "def456",
"components": {"postcode": "20500", "city": "Washington", "region": "DC", "country": "US"}
}
]
}Un exemple plus succinct, et pourquoi il compte
Toutes les adresses ne sont pas aussi complètes. Une requête contenant seulement une ville et une région, comme « Springfield, Illinois », peut quand même renvoyer un résultat, mais le code postal dans components couvrira toute la ville plutôt qu'un seul bâtiment, et le champ precision indiquera un niveau plus grossier que « house ». Cette différence compte si vous prévoyez d'imprimer le code postal renvoyé sur une étiquette d'expédition plutôt que de l'utiliser pour une estimation régionale, car un code postal au niveau de la ville n'offre pas la même garantie qu'un code au niveau du bâtiment.
Faire confiance au résultat
Vérifiez les champs precision et confidence avant de considérer le code postal renvoyé comme fiable. Une précision « house » associée à un score de confiance élevé signifie que la correspondance était suffisamment précise pour se fier directement au code postal. Une précision plus grossière, comme une correspondance au niveau de la rue ou de la ville, signifie que le code postal couvre une zone plus large et pourrait ne pas correspondre à l'adresse exacte que le client voulait indiquer.
Coût de cette recherche
Il s'agit d'une seule recherche, soit une requête décomptée de votre quota quotidien pour une adresse. Le faire pour chaque formulaire de paiement ou d'inscription soumis sans code postal est un usage normal et approchera rarement les 2 500 requêtes gratuites incluses chaque jour avec une clé, ou depuis une même adresse IP sans clé.
Quand il n'y a pas de bonne correspondance
Un tableau results vide, ou un résultat avec un faible score de confiance, signifie que l'adresse était trop vague pour être résolue. Dans ce cas, demandez directement le code postal au client plutôt que de le deviner, car un mauvais code postal sur une étiquette d'expédition pose plus de problèmes qu'un code absent.
Un cas limite à prévoir
Certains pays n'utilisent pas du tout de codes postaux, ou les utilisent de façon si irrégulière que l'objet components omet simplement ce champ pour un résultat donné. Ne considérez pas l'absence du champ postcode comme une erreur en soi : vérifiez d'abord le pays dans l'objet components, et ne signalez la ligne pour vérification que si le pays en question est un pays où un code postal est normalement attendu.
Une vérification complémentaire
Une fois que vous avez un code postal candidat, un appel direct à /v1/postcode avec ce code et le pays issu de l'objet components est un moyen rapide de le revérifier de façon indépendante, particulièrement utile lorsque la confiance du géocodage direct initial était limite plutôt que clairement élevée ou clairement faible.
Compléter ainsi un code postal manquant vous épargne un champ de formulaire et un échange supplémentaire avec le client. Les définitions complètes des champs se trouvent dans la documentation de la recherche de code postal et la documentation du géocodage direct.