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.
Bien lire un score de confiance avant de s'y fier
Une valeur de confiance comprise entre 0.0 et 1.0 sur un résultat de géocodage ressemble à un simple signal de réussite ou d'échec, mais la traiter ainsi passe à côté de ce qu'elle mesure réellement.
Ce que mesure la confiance
La confiance reflète le degré de certitude de la correspondance, compte tenu du texte saisi, que ce résultat précis est bien celui auquel la saisie faisait référence. Un score de confiance élevé sur une saisie ambiguë ou mal formatée signifie toujours que le système est confiant dans sa meilleure hypothèse, et non que la saisie était forcément correcte ou que le lieu existe forcément tel qu'il est décrit.
GET /v1/forward?q=Main Street, Springfield&limit=1{
"status": "ok",
"query": "Main Street, Springfield",
"results": [
{"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
]
}Une confiance de 0.62 reflète ici le fait que de nombreuses villes portent le nom de Springfield : même une correspondance correcte avec un Springfield précis comporte une part d'incertitude inhérente quant à savoir s'il s'agit bien du Springfield visé par la saisie.
Confiance et précision
Ce sont deux champs différents qui mesurent deux choses différentes. La précision décrit le niveau de détail de la correspondance : maison, rue ou niveau plus grossier. La confiance décrit le degré de certitude du système quant à la correspondance trouvée. Un résultat de précision « house » peut quand même avoir un score de confiance modéré si la saisie était ambiguë quant à la maison et à la rue visées, et un résultat de précision « street » peut avoir un score de confiance élevé si la correspondance, bien que grossière, était sans ambiguïté.
Définir un seuil
Choisissez un seuil de confiance en fonction de ce que vous coûterait un résultat erroné. Un seuil de 0.8 ou plus a du sens pour une opération automatisée et lourde de conséquences, comme le remplissage automatique d'une étiquette d'expédition sans vérification humaine. Un seuil plus bas est raisonnable lorsqu'une personne vérifie ensuite le résultat, comme une suggestion présentée à un client pour confirmation.
Combiner avec le paramètre countries
Les correspondances ambiguës comme l'exemple de Springfield ci-dessus se résolvent souvent en restreignant la recherche avec le paramètre countries lorsque vous savez déjà dans quel pays l'adresse doit se trouver, ce qui augmente les chances d'obtenir une correspondance à confiance élevée dès le premier essai au lieu d'avoir besoin d'une seconde recherche.
Le coût reste le même
Bien lire la confiance ne change pas le coût d'une recherche, toujours une requête dans tous les cas. Ce qui change, c'est que vous agissez sur le résultat avec le bon degré de confiance.
La confiance est un signal précis et limité, et non une garantie générale d'exactitude ; la lire ainsi évite d'agir trop vite sur une correspondance fragile. Les définitions complètes des champs se trouvent dans la documentation du géocodage direct.