Preguntas frecuentes sobre la codificación geográfica

Estas preguntas frecuentes abarcan preguntas específicas de la API de Geocoding. Consulta las Preguntas frecuentes de Google Maps Platform para ver preguntas comunes de Google Maps Platform. También consulta Prácticas recomendadas para la geocodificación de direcciones.

Solución de problemas

Solución de problemas

Con el geocodificador, obtengo más consultas que muestran ZERO_RESULTS. ¿A qué se debe?

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

Si tu aplicación trabaja con direcciones ingresadas por el usuario, la función Autocompletado de sitios de la API de Places puede producir resultados de mejor calidad. Place Autocomplete permite a los usuarios seleccionar de un conjunto de resultados según lo que hayan escrito, lo que les permite elegir entre resultados con nombres similares y ajustar su consulta si escriben mal una dirección.

Si tienes una aplicación que se ocupa de consultas ambiguas o incompletas o que pueden contener errores, te recomendamos usar la función Place Autocomplete en la API de Places en lugar del geocodificador directo disponible en la API de Geocoding. Para obtener más información, consulta las Prácticas recomendadas sobre la geocodificación de direcciones y la entrada sobre la codificación geográfica de direcciones en la entrada de blog de las API de Google Maps.

Necesito obtener respuestas rápidamente 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, sean altamente 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 codificación geográfica 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 Geocoding API está optimizada para usarse con direcciones completas, inequívocas y de formato adecuado, como las direcciones de entrega ingresadas en formularios en línea, y, por lo tanto, tiene una latencia más alta que la de autocompletado de sitios. El geocodificador directo tiene una mayor cobertura y una mejor calidad de resultados, pero con una latencia un poco mayor.

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

En lugar de direcciones, usa ID de lugar para especificar waypoints, orígenes y destinos. Los ID de lugar se obtienen mejor con la función Place Autocomplete de la API de Places o la biblioteca de Places en la API de Maps JavaScript. Consulta también la información sobre la opción placeIdOnly, que se puede usar para reducir el costo del autocompletado de sitios.

Cuando se consulta la API de Directions o de Distance Matrix con una string de dirección en lugar de un ID de sitio o un valor de latlng, se utiliza el mismo backend que la API de Geocoding para convertir esa dirección en un ID de lugar antes de calcular las indicaciones. Place Autocomplete es más rápido que la codificación geográfica de direcciones. Para las aplicaciones que usan la API de Directions o Distance Matrix en situaciones muy sensibles a la latencia, como responder a entradas del usuario, te recomendamos usar el autocompletado de sitios para obtener los ID de lugar correspondientes a esas direcciones y pasarlos a la API de Directions o de Distance Matrix. Este enfoque reduce la latencia de manera significativa. Consulta nuestra documentación para obtener un ejemplo de cómo usar Place Autocomplete con las instrucciones sobre cómo llegar.

¿Cómo puedo informar errores en el geocodificador?

Si tienes informes de errores o solicitudes de funciones para el servicio de geocodificador directo, avísanos mediante nuestro seguimiento de problemas público.

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

Comunícanoslo 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 con 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 puedo obtener los mejores resultados con el geocodificador usando filtros 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 URL de solicitud de muestra, 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"Zúrich 8000, Suiza". 
    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 mediante 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 y 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 permite el uso 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 Geocoding API no necesariamente mostrará varios resultados para las consultas ambiguas. Esas consultas se responden mejor con el autocompletado de sitios.

    Ejemplos:

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