Preguntas frecuentes sobre la codificación geográfica

En estas preguntas frecuentes, se incluyen preguntas 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 las Prácticas recomendadas para la geocodificación de direcciones.

Solución de problemas

Solución de problemas

Con el geocodificador, observo un mayor número de consultas que muestran ZERO_RESULTS. ¿A qué se debe?

En el geocodificador, las consultas ambiguas, incompletas o con formato incorrecto, como direcciones con errores ortográficos o inexistentes, tienden a mostrar ZERO_RESULTS. Si no se puede encontrar la dirección, es preferible ZERO_RESULTS antes que un resultado parcial (por ejemplo, mostrar solo el suburbio en lugar de una dirección).

Si tu aplicación trabaja con direcciones ingresadas por el usuario, la función Place Autocomplete de la API de Places podría generar resultados de mejor calidad. Place Autocomplete permite a los usuarios seleccionar opciones de un conjunto de resultados según lo que escribieron, lo que les permite elegir entre resultados con nombres similares y ajustar sus búsquedas si escriben mal una dirección.

Si tienes una aplicación que trabaja con consultas ambiguas, incompletas o 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 información detallada, consulta las prácticas recomendadas para la geocodificación de direcciones y la entrada de blog sobre la geocodificación de direcciones en las APIs de Google Maps.

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

Recomendamos que las aplicaciones que respondan a las entradas del usuario y, por lo tanto, sean muy sensibles a la latencia, usen 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 de formato adecuado, como las direcciones de entrega ingresadas en formularios en línea, por lo que tiene una latencia más alta que Place Autocomplete. El geocodificador directo ofrece una mayor cobertura y una mejor calidad de resultados, pero con una latencia un poco más alta.

¿Cómo puedo mitigar la latencia en las APIs de Directions y de Distance Matrix?

En lugar de direcciones, usa IDs de lugar para especificar puntos de referencia, origen y destino. Los IDs de lugar se obtienen mejor a partir de la función Place Autocomplete de la API de Places o 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 consultan a las APIs de Directions o de Distance Matrix con una cadena de dirección en lugar de un ID de lugar o latlng, utilizan 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 o la API de Distance Matrix en situaciones muy sensibles a la latencia, como responder a entradas del usuario, te recomendamos que utilices Place Autocomplete para obtener los IDs de lugar correspondientes a esas direcciones y pasarlos a la API de Directions o a la API de Distance Matrix. Este enfoque reduce la latencia de forma significativa. Consulta nuestra documentación para ver un ejemplo de cómo usar Place Autocomplete con instrucciones sobre cómo llegar.

¿Cómo puedo notificar errores del geocodificador?

Si tienes informes de errores o solicitudes de funciones para el servicio de geocodificador directo, comunícate con nosotros mediante la 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?

Infórmanos mediante nuestra Herramienta de seguimiento de errores pública y comparte algunas consultas específicas para que podamos investigar si hay errores o problemas sistémicos que causen problemas en la calidad de los resultados, o si hay cambios en la guía de prácticas recomendadas para ayudar a los desarrolladores a obtener mejores resultados.

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

En el geocodificador, el filtrado de componentes solo aplica las restricciones postal_code y country. En los siguientes ejemplos, se muestra 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 por país con un código de país ISO 3166-2. Por ejemplo: components=country:CH|postal_code:8000 muestra "8000 Zúrich, Suiza".
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
    
  • Para restringir las búsquedas 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. No se garantiza que los nombres de países y otras abreviaturas produzcan los mismos resultados que los códigos de país.

    Ejemplos:

    • La geocodificación para components=country:FRA|locality:gallus muestra la sublocalidad de Gallus en Fráncfort del Meno, Alemania. Esto se debe a que no se admite el código de país de 3 letras de Francia (FRA), por lo que se permiten resultados en cualquier país y el resultado en Fráncfort es más adecuado que cualquier otro 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 consultas ambiguas. Place Autocomplete responde mejor esas consultas.

    Ejemplos:

    • La geocodificación para components=country:US|locality:madrid muestra "Madrid, NM 87010, EE.UU.", pero no muestra 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
      
    • El uso de Place Autocomplete para input=madrid&components=country:us&types=(regions) y la especificación de un viewport con location y radius para sesgar los resultados de ubicación genera una respuesta denominada "Madrid" con varias ciudades de EE.UU.
      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