Dos puntos geocodificados separados por unos pocos metros en un mapa pueden representar tipos de coincidencia fundamentalmente distintos, y la diferencia entre ellos, geocodificación a nivel de edificio (rooftop) frente a nivel de calle, es una de las distinciones más importantes que se esconden detrás de un simple punto en la pantalla.
La geocodificación a nivel de edificio sitúa la coordenada devuelta en la ubicación real del edificio concreto que coincide con la dirección, normalmente a partir de datos reales de edificios o parcelas que registran dónde se encuentra esa estructura. Es la categoría de coincidencia más precisa disponible, y es lo que pretende representar el nivel de precisión house en una respuesta: una coordenada que corresponde a un edificio físico identificado, no una estimación de dónde probablemente está.
La geocodificación a nivel de calle funciona de otra manera. En lugar de coincidir con un edificio concreto conocido, interpola una posición a lo largo de un tramo de calle según dónde cabría esperar estadísticamente que cayera el número solicitado dentro del rango conocido de números de ese tramo, suponiendo una distribución más o menos uniforme de las direcciones a lo largo de la calle. Esto produce una coordenada situada sobre la calle correcta o cerca de ella, y aproximadamente en el tramo adecuado, pero es en esencia una estimación basada en patrones de numeración típicos, no una ubicación confirmada de ese edificio concreto.
La diferencia entre ambas importa más de lo que podría parecer al principio, porque la interpolación a nivel de calle supone que la numeración es razonablemente uniforme y secuencial a lo largo de un tramo, una suposición que no siempre se cumple. Cuando una calle se ha urbanizado de forma desigual, cuando la numeración tiene huecos o cuando un tramo largo abarca un amplio rango de direcciones repartidas de forma irregular, un punto interpolado puede quedar a una distancia considerable de la estructura real, a veces un edificio entero o más, aunque el método subyacente funcione exactamente como está diseñado.
Esta es precisamente la distinción que el campo precision está pensado para mostrar, así que siempre hay que comprobarlo en lugar de deducirlo solo de la coordenada, ya que una coincidencia a nivel de edificio y una interpolación a nivel de calle pueden producir en un mapa puntos de aspecto parecido con una precisión real muy distinta. En cualquier caso de uso en el que la diferencia importe de verdad, por ejemplo enviar un servicio técnico a un edificio exacto y no a uno cercano, comprobar específicamente la precisión house, en lugar de aceptar cualquier resultado que se haya resuelto en algún punto de la calle correcta, marca la diferencia entre confiar en una coincidencia confirmada y confiar en una estimación estadística.
Nuestro endpoint de geocodificación directa indica la precisión real obtenida en cada coincidencia, precisamente para que tu aplicación pueda distinguir un resultado confirmado a nivel de edificio de una interpolación a nivel de calle antes de decidir cuánto confiar en él para tu caso de uso concreto.
Una dirección en el centro de una ciudad bien cartografiada no te dice casi nada sobre cómo gestiona tu sistema una ruta rural, una frontera en disputa o una consulta cerca de los polos. Prueba los casos difíciles a propósito.
No todos los conjuntos de datos con información de ubicación de apariencia pública pueden usarse legalmente dentro de un producto de pago. Las condiciones de la licencia, y no la disponibilidad técnica, suelen marcar el límite real.
Cuando una consulta realmente no se puede resolver de forma fiable, no devolver nada es mejor respuesta que devolver una suposición disfrazada de hecho. Este es el razonamiento detrás de esa decisión.