Controla el uso de tu clave antes de alcanzar un límite
Vigilar las cabeceras de cuota sobre la marcha te indica cuándo te acercas a un límite, mucho antes de que se rechace realmente una solicitud.
Interpreta correctamente una puntuación de confianza antes de fiarte de ella
Un valor de confianza entre 0.0 y 1.0 en un resultado de geocodificación parece una simple señal de aprobado o suspenso, pero tratarlo así pasa por alto lo que realmente mide.
Qué mide la confianza
La confianza refleja lo segura que es la coincidencia, dado el texto de entrada, de que este resultado concreto es al que se refería la entrada. Una puntuación de confianza alta con una entrada ambigua o con un formato extraño sigue significando que el sistema confía en su mejor estimación, no que la entrada fuera sin duda correcta ni que la ubicación exista sin duda tal como se describe.
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": {}}
]
}Una confianza de 0.62 en este caso refleja que muchas localidades comparten el nombre Springfield, así que incluso una coincidencia correcta con un Springfield concreto conlleva cierta incertidumbre inherente sobre si es el Springfield al que se refería la entrada.
Confianza frente a precisión
Son dos campos distintos que miden dos cosas distintas. La precisión describe lo específica que es la coincidencia: casa, calle o un nivel más general. La confianza describe lo seguro que está el sistema de la coincidencia que ha encontrado. Un resultado con precisión "house" puede tener una puntuación de confianza moderada si la entrada era ambigua sobre qué casa de qué calle, y un resultado con precisión "street" puede tener una puntuación de confianza alta si la coincidencia, aunque general, no era ambigua.
Fijar un umbral
Elige un umbral de confianza en función de lo que te costaría un resultado erróneo. Un umbral de 0.8 o superior tiene sentido para algo automatizado y con consecuencias, como rellenar automáticamente una etiqueta de envío sin revisión humana. Un umbral más bajo es razonable para algo en lo que una persona revisa el resultado después, como una sugerencia que se muestra al cliente para que la confirme.
Combinación con el parámetro countries
Las coincidencias ambiguas como la del ejemplo de Springfield se resuelven a menudo acotando la búsqueda con el parámetro countries cuando ya sabes en qué país debería estar la dirección, lo que aumenta las probabilidades de obtener una coincidencia de alta confianza al primer intento en lugar de necesitar una segunda consulta.
El coste es el mismo
Leer correctamente la confianza no cambia lo que cuesta una consulta, que sigue siendo una solicitud en cualquier caso. Lo que cambia es si actúas sobre el resultado con el grado de confianza adecuado.
La confianza es una señal específica y limitada, no una garantía general de exactitud, y leerla así evita actuar demasiado rápido ante una coincidencia dudosa. Las definiciones completas de los campos están en la documentación de geocodificación directa.