Preguntas frecuentes sobre la codificación geográfica

Estas Preguntas frecuentes incluyen cuestiones específicas de la API de Geocoding. Consulta las Preguntas frecuentes sobre Google Maps Platform para conocer las cuestiones comunes acerca de dicho producto. Consulta también Prácticas recomendadas para la geocodificación de direcciones.

Solución de problemas

Solución de problemas

Estoy recibiendo más búsquedas que devuelven ZERO_RESULTS con el geocodificador. ¿Qué sucede?

En el geocodificador, las búsquedas ambiguas, incompletas y con formato incorrecto, como las direcciones con errores ortográficos o inexistentes, son propensas a producir ZERO_RESULTS. Si no se puede encontrar la dirección, es preferible que se devuelva ZERO_RESULTS en lugar de un resultado parcial (por ejemplo, que se devuelva solo el suburbio en lugar de una dirección).

Si tu aplicación procesa direcciones que ingresan los usuarios, la función Place Autocomplete de la API de Places puede producir resultados de mejor calidad. Place Autocomplete permite a los usuarios seleccionar entre un conjunto de resultados según lo que escribieron, lo que les permite elegir entre resultados con nombres similares y ajustar su búsqueda si escriben mal una dirección.

Si tienes una aplicación que procesa búsquedas ambiguas o incompletas, o bien búsquedas que pueden contener errores, te recomendamos que uses la función Place Autocomplete de la API de Places en lugar del geocodificador directo disponible en la API de Geocoding. Para obtener más detalles, consulta las prácticas recomendadas para geocodificar direcciones y la entrada de blog sobre geocodificación de direcciones en las APIs de Google Maps.

Necesito respuestas rápidas, y el geocodificador es demasiado lento para mi aplicación. ¿Qué puedo usar para obtener respuestas más rápidas?

Recomendamos que las aplicaciones que responden a la entrada del usuario y, por lo tanto, son muy sensibles a la latencia, utilicen la función Place Autocomplete de la API de Places (también disponible en JavaScript, Android o iOS) en lugar de la geocodificación de direcciones. Esta función está optimizada para usarse de manera interactiva; por lo tanto, su latencia es muy reducida.

La geocodificación de direcciones en la API de Geocoding está optimizada para usarse con direcciones completas, inequívocas y con un formato adecuado, como las direcciones de entrega que se ingresan en formularios en línea, por lo que tiene una latencia más alta que Place Autocomplete. El geocodificador directo tiene una mayor cobertura y una mejor calidad de los resultados, pero con una latencia algo mayor.

¿Cómo puedo mitigar la latencia en la API de Directions (heredada) y la API de Distance Matrix (heredada)?

En lugar de direcciones, usa IDs de lugar para especificar puntos de referencia, origen y destino. Lo mejor es obtener los IDs de lugar de la función Place Autocomplete de la API de Places o de la biblioteca de Places de la API de Maps JavaScript. Consulta también la información sobre la opción placeIdOnly, que se puede usar para reducir el costo de Place Autocomplete.

Cuando se consulta la API de Directions (heredada) o la API de Distance Matrix (heredada) con una cadena de dirección en lugar de un ID de lugar o una latitud y longitud, se usa el mismo backend que la API de Geocoding para convertir esa dirección en un ID de lugar antes de calcular las instrucciones sobre cómo llegar. Place Autocomplete es más rápido que la geocodificación de direcciones. En el caso de las aplicaciones que usan la API de Directions (heredada) o la API de Distance Matrix (heredada) en situaciones muy sensibles a la latencia, como cuando se responde a la entrada del usuario, te recomendamos que uses Place Autocomplete para obtener los IDs de lugar correspondientes a esas direcciones y que los pases a la API de Directions (heredada) o a la API de Distance Matrix (heredada). Este enfoque reduce la latencia de forma significativa. Consulta nuestra documentación para ver un ejemplo de cómo usar Place Autocomplete con Directions.

¿Cómo informo errores en el geocodificador?

Si tienes algún informe de errores o solicitud de función para el servicio de geocodificación directa, infórmanos a través de nuestra herramienta de seguimiento de errores pública.

El geocodificador no produce buenos resultados para mi caso de uso. ¿Qué tipo de ayuda se encuentra disponible?

Avísanos a través de nuestro seguimiento de problemas público y comparte algunas búsquedas específicas para que podamos investigar si hay errores o problemas sistémicos que causen problemas con la calidad de los resultados, o si hay cambios que podamos realizar en la guía de prácticas recomendadas para ayudar a los desarrolladores a obtener mejores resultados.

¿Cómo puedo obtener los mejores resultados con el geocodificador usando el filtrado de componentes?

En el geocodificador, el filtrado de componentes solo aplica las restricciones de postal_code y country. En los siguientes ejemplos, se ilustra la mejor manera de usar el filtrado de componentes, según los resultados que necesites. En las URLs de solicitud de ejemplo, asegúrate de reemplazar `YOUR_API_KEY` por tu clave de API real.

  • Para restringir los códigos postales a un país específico, asegúrate de especificar la restricción de país con un código de país ISO 3166-2. Por ejemplo: components=country:CH|postal_code:8000 devuelve "8000 Zürich, Switzerland". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Para restringir las consultas a un país específico, asegúrate de especificar la restricción por país con un código de país ISO 3166-2. Es posible que los nombres de países y otras abreviaturas no produzcan los mismos resultados que los códigos de país.

    Ejemplos:

    • La geocodificación de components=country:FRA|locality:gallus devuelve la sublocalidad de Gallus en Frankfurt am Main, Alemania. Esto se debe a que no se admite el código de país de 3 letras para Francia (FRA), por lo que se permiten resultados en cualquier país, y el resultado en Frankfurt es más adecuado que cualquier resultado en Francia. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • La API de Geocoding no necesariamente devolverá varios resultados para las búsquedas ambiguas. Estas consultas se responden mejor con Place Autocomplete.

    Ejemplos:

    • La geocodificación de components=country:US|locality:madrid devuelve "Madrid, NM 87010, USA", pero ninguna de las otras ciudades de EE.UU. llamadas "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Usar Place Autocomplete para input=madrid&components=country:us&types=(regions) y, también, especificar un viewport con location y radius para sesgar los resultados de ubicación genera una respuesta con varias ciudades de EE.UU. llamadas "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY