En estas Preguntas frecuentes, se abordan 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 Prácticas recomendadas para geocodificar direcciones.
Solución de problemas
- Recibo más consultas que muestran ZERO_RESULTS con el geocodificador. ¿Qué sucede?
- Necesito respuestas rápidas, y el geocodificador es demasiado lento para mi aplicación. ¿Qué puedo usar para obtener respuestas más rápidas?
- ¿Cómo puedo mitigar la latencia en las APIs de Directions y de Distance Matrix?
- Soy cliente del Plan Premium y la API de Places es demasiado costosa. ¿Qué puedo hacer para reducir los costos?
- ¿Cómo informo errores en el geocodificador?
- El geocodificador no produce buenos resultados para mi caso de uso. ¿Qué ayuda está disponible?
- ¿Cómo puedo obtener los mejores resultados con el geocodificador mediante el filtrado de componentes?
Solución de problemas
- Recibo más consultas que muestran ZERO_RESULTS con el geocodificador. ¿Qué sucede?
-
En el geocodificador, las consultas ambiguas, incompletas y con formato incorrecto, como direcciones con errores ortográficos o inexistentes, suelen generar ZERO_RESULTS. Si no se puede encontrar la dirección, es preferible ZERO_RESULTS a un resultado parcial (por ejemplo, mostrar solo el suburbio en lugar de una dirección).
Si tu aplicación se ocupa de las entradas de direcciones del usuario, 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 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 que uses 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 Prácticas recomendadas para geocodificar direcciones y Geocodificación de direcciones en la entrada de blog de 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 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, sin ambigüedades y con un formato correcto, 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 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 lugares para especificar puntos de referencia, origen y destino. Los IDs de lugar se obtienen mejor de la función Place Autocomplete en la API de Places o de 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 de Place Autocomplete.Cuando se consulta la API de Directions o la API de Distance Matrix con una cadena de dirección en lugar de un ID de lugar o latlng, usan 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 las entradas del usuario, te recomendamos que uses 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 significativamente la latencia. Consulta nuestra documentación para ver un ejemplo de cómo usar Place Autocomplete con instrucciones sobre cómo llegar.
- ¿Cómo informo errores en el geocodificador?
-
Si tienes informes de errores o solicitudes de funciones para el servicio de geocodificador de reenvío, comunícate con nosotros a través de nuestro seguimiento de problemas público.
- El geocodificador no produce buenos resultados para mi caso de uso. ¿Qué tipo de ayuda se encuentra disponible?
-
Infórmanos mediante nuestro seguimiento de problemas público y comparte algunas consultas específicas para que podamos investigar si hay errores o problemas sistémicos que causan problemas con la calidad de los resultados, o si hay algún cambio 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 mediante el filtrado de componentes?
-
En el geocodificador, el filtrado de componentes aplica solo las restricciones de
postal_codeycountry. En los siguientes ejemplos, se ilustra cómo usar mejor el filtrado de componentes, según los resultados que necesites. En las URLs 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 de país con un código de país ISO 3166-2.
Por ejemplo,
components=country:CH|postal_code:8000muestra “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 de país con un código de país ISO 3166-2. No se garantiza que los nombres de los países ni otras abreviaturas produzcan los mismos resultados que los códigos de país.
Ejemplos:
- La geocodificación de
components=country:FRA|locality:gallusmuestra 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 de cualquier país y el resultado en Frankfurt 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 geocodificación de
- La API de Geocoding no necesariamente mostrará varios resultados para las consultas ambiguas. Place Autocomplete responde mejor a estas consultas.
Ejemplos:
- La geocodificación de
components=country:US|locality:madridmuestra "Madrid, NM 87010, EE.UU.", pero no muestra ninguna de las otras ciudades de EE.UU. que se llaman "Madrid".https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY - Si usas Place Autocomplete para
input=madrid&components=country:us&types=(regions)y también especificas un viewport conlocationyradiuspara sesgar los resultados de la ubicación, se genera una respuesta con varias ciudades de EE.UU. que se llaman "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
- La geocodificación de
- 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,