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.
Geocodifica direcciones que incluyen número de piso o de apartamento
Un número de apartamento añadido a una dirección es algo normal en muchas direcciones reales, y vale la pena entender cómo lo trata una consulta de geocodificación en lugar de eliminarlo antes de enviar la solicitud, que es una costumbre habitual pero innecesaria.
Enviar la dirección completa
Incluye el número de apartamento o de unidad como parte de la consulta de texto libre, igual que cualquier otra parte de la dirección.
GET /v1/forward?q=Apt 4B, 350 Fifth Avenue, New York&limit=1{
"status": "ok",
"query": "Apt 4B, 350 Fifth Avenue, New York",
"results": [
{
"formatted": "350 Fifth Avenue, New York, NY",
"lat": 40.7484,
"lon": -73.9857,
"type": "address",
"precision": "house",
"confidence": 0.95,
"place_id": "es234",
"components": {"house_number": "350", "street": "Fifth Avenue", "city": "New York", "region": "NY", "country": "US"}
}
]
}Por qué el número de unidad no aparece en las coordenadas
Las coordenadas de una consulta de geocodificación identifican un edificio, no una unidad concreta dentro de él, ya que los apartamentos individuales no tienen una ubicación cartografiada propia como la tiene un edificio. No se espera que la parte de apartamento o unidad de una dirección cambie los valores de lat y lon, y también es de esperar que no aparezca en el objeto components, no es señal de que la entrada se haya ignorado o tratado mal.
Un segundo ejemplo: un número de oficina en un edificio comercial
El mismo patrón se aplica a la dirección de una empresa con un número de oficina o de planta.
GET /v1/forward?q=Suite 200, 1 Example Plaza, Chicago&limit=1Un gran edificio de oficinas que alberga decenas de empresas distintas se geocodifica igualmente en un único conjunto de coordenadas del edificio, sin importar qué oficina se indique en la consulta, exactamente igual que un edificio de apartamentos. Todo lo que distinga a un inquilino de otro dentro de ese edificio tiene que estar en tus propios registros, no en las coordenadas.
Un error habitual que debes evitar
No intentes compensar la falta del componente de unidad añadiéndolo tú mismo después al código postal o a otro campo de componente, por ejemplo escribiendo un código postal como "20500 Apt 4B". Hacerlo corrompe un campo que otros sistemas, incluidas tu propia validación y cualquier consulta de direcciones posterior, esperan que contenga solo un código postal real. Mantén el número de unidad en su propio campo, totalmente separado de todos los componentes geocodificados.
Guardar el número de unidad por separado
En lugar de incluir el número de unidad en la cadena de dirección que geocodificas cada vez, guárdalo como un campo propio en tu modelo de datos junto a la dirección geocodificada del edificio. Así la solicitud de geocodificación se centra en lo que realmente afecta al resultado, la ubicación del edificio, y a la vez conservas la información de la unidad para etiquetas de envío o registros internos.
Cuándo importa para la entrega
Un mensajero o un servicio postal necesita el número de unidad para la entrega real, aunque no haya tenido ningún papel en las coordenadas. Mantén ambos datos, las coordenadas geocodificadas del edificio y el número de unidad guardado por separado, juntos en el registro de entrega final para que no se pierda nada por el camino.
Un caso límite que conviene conocer
Una sola dirección de edificio puede albergar a muchos residentes o inquilinos distintos, todos con las mismas coordenadas y el mismo resultado de consulta de código postal. Si estás contrastando el código postal de un cliente con una dirección obtenida por geocodificación directa, como se explica en la guía de verificación cruzada del código postal, recuerda que esta relación de muchos a uno entre unidades y un edificio es de esperar y no es en sí misma señal de un problema en los datos.
El coste no cambia
Tanto si una dirección incluye un número de apartamento o de unidad como si no, la consulta sigue costando una solicitud, igual que cualquier otra llamada de geocodificación directa.
Incluir un número de unidad en la consulta no causa ningún problema, y no hace falta eliminarlo para obtener una geocodificación precisa, aunque separarlo después en su propio campo guardado mantiene tus datos más limpios. Consulta la documentación de geocodificación directa para ver la lista completa de componentes.