Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps Geocoding API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps Geocoding API
  3. Crear claves correspondientes
Continuar

Prácticas recomendadas para la geocodificación de direcciones

La geocodificación es el proceso que convierte direcciones (como la dirección de una calle) en coordenadas geográficas (latitud y longitud) que puedes usar para disponer marcadores en un mapa o posicionar el mapa. El objetivo de este documento es aclarar algunas consideraciones sobre la geocodificación de direcciones. En este documento, se describe el momento oportuno para usar la Google Maps Geocoding API, el servicio de autocompletado de sitios de Places API o el servicio de búsqueda de texto de Places API.

En general, debes emplear la Google Maps Geocoding API cuando realices la geocodificación de direcciones completas (por ejemplo, “48 Pirrama Rd, Pyrmont, NSW, Australia”). Usa el servicio de autocompletado de sitios de la Places API cuando realices la geocodificación de direcciones ambiguas (incompletas) o en casos de alta latencia, como cuando respondas a entradas del usuario. Cuando realices la geocodificación de direcciones ambiguas en sistemas automatizados y no haya usuarios para seleccionar un elemento de las sugerencias de autocompletado, emplea el servicio de búsqueda de texto de la Places API en lugar del autocompletado de sitios.

Casos de uso y recomendaciones de API

Caso de uso Recomendación de API
Direcciones postales completas e inequívocas Servicio web de Google Maps Geocoding API.
Consultas ambiguas de un usuario (por ejemplo, direcciones incompletas o con formato erróneo) Servicio de autocompletado de sitios de la Places API para obtener un ID de sitio. Después, la Geocoding API para realizar la geocodificación del ID del sitio en un valor latlng.
Consultas ambiguas en un sistema automatizado (por ejemplo, direcciones incompletas o con formato erróneo) Servicio de búsqueda de texto de la Places API para obtener ID de sitios. Después, la Geocoding API para realizar la geocodificación de los ID de sitio en valores latlng.
Respuestas a entradas del usuario en tiempo real Servicio de autocompletado de sitios de la Places API para obtener un ID de sitio. Después, la Geocoding API para realizar la geocodificación del ID del sitio en un valor latlng.
Problemas de latencia al usar la Google Maps Directions API o Distance Matrix API con orígenes, destinos o waypoints especificados como strings de direcciones Reducir la latencia de geocodificación usando el servicio de autocompletado de sitios de la Places API para obtener los ID de sitios y, a continuación, pasarlos a la Directions API o Distance Matrix API.

Direcciones completas

El mejor método para gestionar consultas inequívocas, como strings de direcciones postales completas (por ejemplo, “48 Pirrama Rd, Pyrmont, NSW, Australia”), es el servicio web de la Geocoding API. El backend de geocodificación de direcciones proporciona una mayor cobertura de direcciones a nivel global, y está optimizado para brindar resultados de gran calidad con estos tipos de consultas completas e inequívocas.

Consultas ambiguas

Las consultas ambiguas son aquellas que contienen direcciones con formato erróneo, direcciones incompletas o componentes superfluos de estas. El geocodificador del servicio web de la Geocoding API no está diseñado para trabajar con consultas ambiguas y es posible que brinde resultados menos precisos (o nulos) en respuesta a consultas ambiguas, sobre todo en el caso de consultas con varios errores ortográficos o términos irrelevantes que no correspondan a la dirección.

Si tu caso de uso permite que los usuarios ingresen consultas ambiguas (como “123 Main Street”), recomendamos usar el servicio de autocompletado de sitios de la Places API, ya que está diseñado para mostrar varias opciones posibles y permitir que el usuario elija una de ellas. Se puede restringir la Places API para que solo busque geocódigos o direcciones y excluya los negocios. Además, la función de búsqueda con autocompletado se puede restringir para mostrar resultados específicos de una ubicación. Places API muestra un ID de sitio que se puede pasar al servicio web de Geocoding API como una ubicación completamente inequívoca. A continuación, este servicio devolverá la información completa de la dirección y realizará la geocodificación de la dirección en un valor latlng. Obtén más información sobre el servicio de autocompletado de sitios para Android, iOS, JavaScript y el Places API Web Service.

Si debes emplear la geocodificación de direcciones en un sistema automatizado y no hay usuarios para seleccionar entre varios resultados posibles, pero las consultas pueden ser ambiguas o estar incompletas, puedes usar el servicio de búsqueda de texto de Places API en lugar del servicio de autocompletado de sitios. La búsqueda de sitios es mejor que Geocoding API para trabajar con consultas ambiguas. Además, te permite restringir la búsqueda a un área específica o clasificar resultados por distancia, lo cual permitirá filtrar y clasificar los resultados con más precisión en consultas ambiguas o incompletas.

Responder a entradas del usuario

Las aplicaciones que respondan en tiempo real a las entradas del usuario cuentan con dos consideraciones importantes que influirán en la elección de la API:

  1. Por lo general, las entradas de usuario involucran el ingreso de direcciones de manera progresiva. En consecuencia, será beneficioso poder realizar la geocodificación de direcciones incompletas y ambiguas porque el usuario podrá obtener resultados más rápido.
  2. Las aplicaciones que responden a entradas del usuario son muy sensibles a la latencia.

Estas dos consideraciones convierten al servicio de autocompletado de sitios de la Places API en el método ideal para el caso de uso que involucre respuestas a entradas del usuario. En Geocoding API, la geocodificación de direcciones tiene mucha más latencia y brinda resultados menos precisos para consultas incompletas o ambiguas. Por lo tanto, no se recomienda para aplicaciones que deban responder a entradas del usuario en tiempo real. Obtén más información sobre el servicio de autocompletado de sitios para Android, iOS, JavaScript y el Places API Web Service.

Reducir latencia para la Directions API y la Distance Matrix API

Cuando los orígenes, destinos y waypoints se especifican como strings de direcciones, la Google Maps Directions API y la Distance Matrix API usan el mismo backend que Geocoding API para realizar la geocodificación de estas direcciones antes de calcular las indicaciones. Esto aumenta la latencia de forma significativa en comparación con la especificación de ubicaciones como valores latlng o ID de sitios.

Si tu aplicación usa Directions API o Distance Matrix API en una situación de sensibilidad a la latencia, como cuando se debe responder a las entradas de usuario, y tus orígenes, destinos o waypoints se especifican inicialmente como strings de direcciones, recomendamos minimizar la latencia con el servicio de autocompletado de sitios de la Places API para convertir strings de direcciones en ID de sitios, y después pasar estos ID a la Directions API o Distance Matrix API. Obtén más información sobre el servicio de autocompletado de sitios para Android, iOS, JavaScript y el Places API Web Service. También puedes consultar un ejemplo de JavaScript con autocompletado de sitios y direcciones.

Conclusión

Según del caso de uso, si usas la Geocoding API, la Places API, el servicio de autocompletado de sitios o el servicio de búsqueda de sitios junto con la Geocoding API, podrás crear aplicaciones que ofrezcan a los usuarios resultados precisos de geocodificación además de una latencia baja al realizar la geocodificación de direcciones.

Gestionar errores y reintentos

Si recibes respuestas UNKNOWN_ERROR, significa que ocurrieron errores transitorios. La mejor forma de solucionar esto es realizar un nuevo intento tras una demora breve. Recomendamos usar las bibliotecas de cliente de los servicios web de las Google Maps APIs, que incluyen la lógica de reintento y admiten la autenticación del Google Maps APIs Premium Plan. Java Client, Python Client, Go Client y Node.js Client para Google Maps Services son bibliotecas de cliente admitidas en la comunidad; es posible descargarlas y realizar contribuciones en GitHub, donde también encontrarás instrucciones de instalación y códigos de ejemplo.

Si obtienes un código de estado OVER_QUERY_LIMIT como respuesta, significa que excediste el límite de uso de la API. Te recomendamos probar estas estrategias para optimizar el uso.

Enviar comentarios sobre…

Google Maps Geocoding API
Google Maps Geocoding API
¿Necesitas ayuda? Visita nuestra página de asistencia.