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

Preguntas frecuentes sobre el nuevo geocodificador directo

En esta sección se abarcan preguntas frecuentes específicas sobre el nuevo geocodificador directo que se anunció en la entrada de blog sobre geocodificación de direcciones en las Google Maps APIs. También puedes consultar Prácticas recomendadas para la geocodificación de direcciones.

Consulta las preguntas frecuentes sobre Google Maps APIs para hallar preguntas comunes a todas las Google Maps APIs.

Primeros pasos

Solución de problemas

Primeros pasos

¿Cuándo se convertirá el nuevo geocodificador directo en la opción predeterminada?
  • En las solicitudes al servicio de geocodificación de la Google Maps Geocoding API y la Google Maps JavaScript API, el nuevo geocodificador directo es la opción predeterminada para las solicitudes no identificadas y los clientes del plan estándar. Para los clientes del Premium Plan que usen estas API, el cambio se realizará el 17 de enero de 2017.
  • Para todos los clientes (plan estándar y Premium Plan) que usen Google Maps Directions API, Google Maps Distance Matrix API, Google Static Maps API y Google Street View Image API, y para las solicitudes de la Google Maps JavaScript API a los servicios de indicaciones y de matriz de distancia, el nuevo geocodificador directo se convertirá en la opción predeterminada el 24 de enero de 2017.
  • A fines de marzo de 2017, el geocodificador anterior dejará de usarse de forma permanente.

Estas fechas están sujetas a demoras en caso de problemas imprevistos o del lanzamiento de otras funcionalidades en la misma fecha. Si necesitas realizar cambios en tu sistema antes de la implementación del nuevo geocodificador, los cambios deben estar en la etapa de producción antes de estas fechas.

¿Cuáles son las API que usarán el nuevo geocodificador directo?

Las siguientes Google Maps APIs emplean el mismo geocodificador para las siguientes solicitudes:

Nota: El nuevo geocodificador directo nunca se usa al obtener información de un ID de sitio.

¿Cómo puedo usar el nuevo geocodificador directo hasta que se convierta en la opción predeterminada?

Ya puedes usar el nuevo geocodificador directo con la Geocoding API, la Directions API y la Distance Matrix API, y con los servicios de geocodificación, indicaciones y matriz de distancia disponibles en la Maps JavaScript API.

En la Geocoding API, la Directions API y la Distance Matrix API, agrega el parámetro opcional new_forward_geocoder=true a tus solicitudes.

Para usar en nuevo geocodificador directo en las bibliotecas de cliente de los servicios web de las Google Maps APIs, agrega new_forward_geocoder=true a tus solicitudes. Se trata de un parámetro de URL personalizada que se agregó recientemente a las bibliotecas de cliente.

En los servicios de geocodificación, indicaciones y matriz de distancia disponibles en la Maps JavaScript API, fija el nuevo parámetro opcional newForwardGeocoder: true en el objeto de solicitud adecuado. Este parámetro está disponible en la versión experimental y la versión de lanzamiento.

La herramienta de geocodificación de Google Maps API se actualizó con una configuración opcional. Cuando uses la herramienta, selecciona “Use the new forward geocoder” si deseas generar resultados basados en la funcionalidad del nuevo geocodificador directo.

Nota: El nuevo geocodificador directo todavía no está disponible en la Static Maps API y la Street View Image API.

¿Cómo puedo usar el geocodificador directo anterior si ya no es la opción predeterminada?

Puedes usar el geocodificador directo anterior hasta su discontinuación permanente (29 de marzo de 2017).

En la Geocoding API, la Directions API y la Distance Matrix API, agrega el parámetro opcional new_forward_geocoder=false a tus solicitudes.

Para usar el nuevo geocodificador directo en las bibliotecas de cliente de los servicios web de las Google Maps APIs, agrega new_forward_geocoder=false a tus solicitudes. Se trata de un parámetro de URL personalizada que se agregó recientemente a las bibliotecas de cliente.

En los servicios de geocodificación, indicaciones y matriz de distancia disponibles en la Maps JavaScript API, fija el nuevo parámetro opcional newForwardGeocoder: false en el objeto de solicitud adecuado. Este parámetro está disponible en la versión experimental y la versión de lanzamiento.

Nota: En el caso de la Static Maps API y la Street View Image API, el nuevo geocodificador directo todavía no está disponible; por lo tanto, no hay necesidad de fijar esta opción en false. Por el momento, la Static Maps API y la Street View Image API siguen usando el geocodificador directo anterior.

¿Por qué se realiza este cambio?

El nuevo geocodificador directo es el mismo que usa la aplicación Google Maps para consumidores. El geocodificador anterior quedará obsoleto y dejará de usarse.

¿Este cambio es compatible con versiones anteriores?

Sí, la Geocoding API conserva el mismo formato de solicitud y respuesta. Es posible que el nuevo geocodificador muestre un conjunto diferente de resultados en muchas consultas, pero las solicitudes seguirán funcionando en el formato actual y los nuevos resultados muestran los mismos campos.

Solución de problemas

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

En el nuevo geocodificador, las consultas ambiguas, incompletas o con formato erróneo tienen tendencia a mostrar ZERO_RESULTS. En el geocodificador anterior, estas consultas generalmente muestran resultados incorrectos (por ejemplo, muestran el suburbio si no se encuentra la dirección). Consideramos que ZERO_RESULTS es una respuesta más adecuada para estos casos.

Si tu aplicación trabaja con direcciones ingresadas por el usuario, la función de autocompletado de sitios de la Places API mostrará resultados de mejor calidad. Esta función permite a los usuarios seleccionar opciones de un conjunto de resultados según lo que hayan escrito. De esta forma, los usuarios podrán elegir entre resultados con nombre similar y corregir la consulta si escribieron mal una dirección.

Si la entrada de tu aplicación proviene de un sistema automatizado en el cual no hay usuarios que seleccionen opciones de un conjunto de sugerencias de autocompletado, y posiblemente haya consultas ambiguas, incompletas o que contengan componentes sin dirección (como nombres de negocios), la búsqueda de texto de la Places API puede ser una opción más adecuada. Es más probable que la búsqueda de texto muestre resultados en consultas ambiguas porque estos tipos de consultas pueden contener nombres de negocios (elementos que la Geocoding API no tiene en cuenta).

Si tu aplicación trabaja con consultas ambiguas, incompletas o que puedan contener componentes sin dirección, recomendamos usar la Places API en lugar del geocodificador directo disponible en la Geocoding API. Para obtener más información, consulta Prácticas recomendadas para la geocodificación de direcciones y la entrada de blog sobre la geocodificación de direcciones en las Google Maps API.

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

Para las aplicaciones que respondan a entradas del usuario y, como consecuencia, sean muy sensibles a la latencia, recomendamos usar la función de autocompletado de sitios de la Places API (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 Geocoding API está optimizada para usarse con direcciones completas, inequívocas y de formato adecuado, como las direcciones de entrega que se ingresan en formularios en línea, y tiene más latencia que el autocompletado de sitios. Esto también ocurre con el geocodificador directo anterior. La diferencia de latencia entre el autocompletado de sitios y el nuevo geocodificador directo aumenta aún más, ya que el nuevo geocodificador ofrece mayor cobertura y resultados de mejor calidad, pero genera más latencia.

¿Cómo puedo disminuir la latencia en la Directions API y la Distance Matrix API?

En lugar de direcciones, usa ID de sitios para especificar waypoints, orígenes y destinos. El mejor recurso para obtener estos ID es la función de autocompletado de sitios de la Places API o la biblioteca de sitios de la Maps JavaScript API. Consulta también la información de la opción placeIdOnly, que se puede usar para reducir el costo del autocompletado de sitios.

Cuando se realizan consultas a la Directions API o a la Distance Matrix API con una string de dirección en lugar de un ID de sitio o un valor de latlng, se emplea el mismo backend de la Geocoding API para convertir la dirección en un ID de sitio antes de calcular las indicaciones. El autocompletado de sitios es más rápido que la geocodificación de direcciones. Para las aplicaciones que usan la Directions API o la Distance Matrix API en situaciones muy sensibles a la latencia, como la respuesta a entradas del usuario, recomendamos usar el autocompletado de sitios para obtener los ID de sitio correspondientes a dichas direcciones y pasarlos a la Directions API o la Distance Matrix API. De esta forma, se reduce la latencia considerablemente (aun más que en el geocodificador de direcciones anterior). Consulta nuestra documentación para ver un ejemplo relacionado con la forma de usar el autocompletado de sitios con indicaciones.

Soy cliente del plan premium y la Places API es demasiado costosa. ¿Qué puedo hacer para reducir los costos?

Te recomendamos usar el widget autocomplete (de autocompletado) de sitios de la Maps JavaScript API. Para reducir los costos relacionados con el uso del widget autocomplete, usa la nueva opción placeIdOnly a fin de habilitar el acceso directo a los ID de sitio desde el servicio de autocompletado de sitios. La opción placeIdOnly omite las solicitudes de información de los sitios en aplicaciones que solo necesitan una dirección y no toda la información de un negocio. Para obtener la dirección correspondiente, pasa los ID de sitio al servicio de geocodificación o a la Geocoding API. También puedes pasar los ID de sitio al servicio de indicaciones o de matriz de distancia, o bien a la Directions API o la Distance Matrix API, en lugar de una string de texto con la dirección o el par de latitud y longitud.

Se ha actualizado la herramienta de geocodificación de Google Maps API y el ejemplo de autocompletado de sitios e indicaciones para demostrar el uso de la nueva opción placeIdOnly.

¿Cómo puedo notificar errores del nuevo geocodificador

Si deseas notificar errores o solicitar funciones del nuevo servicio de geocodificador directo, usa nuestro seguimiento de problemas de acceso público.

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

A través de nuestro seguimiento de problemas de acceso público, puedes compartir algunas consultas específicas que produzcan peores resultados con el nuevo geocodificador para que podamos verificar si existen errores o problemas sistémicos que generen inconvenientes en la calidad de los resultados, o si hay algún cambio que podamos aplicar en la guía de prácticas recomendadas para ayudar a los desarrolladores a obtener mejores resultados.

En el nuevo geocodificador, el filtrado de componentes no funciona de la misma manera que en el geocodificador anterior. ¿Cómo puedo obtener los mejores resultados con el nuevo geocodificador usando el filtrado de componentes?

En el nuevo geocodificador, el filtrado de componentes solo se admite en su totalidad para resultados en el nivel de las direcciones. Se admiten parcialmente las restricciones por código de país (por ejemplo, components=country:GB) o código postal para resultados de localidad y de nivel superior. En los siguientes ejemplos, se demuestra la mejor forma de usar el filtrado de componentes, según los resultados que necesites. En las URL de solicitud de ejemplo, no olvides reemplazar “YOUR_API_KEY” por tu clave de API.

  • Para restringir las direcciones (incluso los edificios, las calles y las carreteras) a un área política (país, localidad, etc.), usa el filtrado de componentes como en el geocodificador anterior. Este uso es compatible en el nuevo geocodificador. Por ejemplo, address=gordon&components=locality:dublin muestra “Gordon Way, Dublin, OH 43017, USA”.
    https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&address=gordon&components=locality:dublin&key=YOUR_API_KEY
    
  • Para restringir los códigos postales a un país determinado, usa el filtrado de componentes como en el geocodificador anterior, pero asegúrate de especificar la restricción por país con un código de país ISO 3166-2. Este uso es compatible en el nuevo geocodificador. Por ejemplo, components=country:CH|postal_code:2000 muestra “2000 Neuchâtel, Switzerland”.
    https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=country:CH%7Cpostal_code:2000&key=YOUR_API_KEY
    
  • Para restringir otras consultas que no sean de direcciones (ciudades o barrios, por ejemplo) a un país determinado, usa el filtrado de componentes como en el geocodificador anterior, pero asegúrate de especificar la restricción por país con un código de país ISO 3166-2. En el nuevo geocodificador, no se garantiza que este método permita obtener los mismos resultados que en el geocodificador anterior. Usa el autocompletado de sitios para obtener mejores resultados que estén restringidos al país deseado.

    Ejemplos:

    • Cuando se usa el geocodificador anterior, si se realiza la geocodificación de components=country:US%7Clocality:paris, se muestran varias ciudades de EE. UU. llamadas “Paris”.
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=false&components=country:US%7Clocality:paris&key=YOUR_API_KEY
      
    • Cuando se usa el nuevo geocodificador, si se realiza la geocodificación de components=country:US%7Clocality:paris, se muestra “Paris, TX, USA” y no aparece ninguna de las demás ciudades de EE. UU. llamadas “Paris”.
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=country:US%7Clocality:paris&key=YOUR_API_KEY
      
    • Cuando se usa el autocompletado de sitios para input=paris&components=country:us&types=(regions), y especificar una ventana de visualización con location y radius para predisponer los resultados de la ubicación, se genera una respuesta con varias ciudades de EE. UU. llamadas “Paris”.
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=paris&components=country:us&types=(regions)&key=YOUR_API_KEY
      
  • Para restringir otras consultas sin direcciones (ciudades o barrios, por ejemplo) a un área que no sea un país determinado, no se garantiza que el uso del filtrado de componentes en el nuevo geocodificador permita obtener los mismos resultados que en el geocodificador anterior. Usa el autocompletado de sitios para obtener mejores resultados restringidos al área especificada (location y radius). También puedes usar el nuevo parámetro strictbounds para restringir los resultados al área especificada.

    Ejemplos:

    • Cuando se usa el geocodificador anterior, si se realiza la geocodificación de administrative_area:Anaga|locality:Santa+Cruz, se muestran la localidad de Santa Cruz de Tenerife y el área administrativa de Anaga.
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=false&components=administrative_area:Anaga%7Clocality:Santa%20Cruz&key=YOUR_API_KEY
      
    • Cuando se usa el nuevo geocodificador, si se realiza la geocodificación de administrative_area:Anaga|locality:Santa+Cruz, se muestra solo el área administrativa de Anaga y no aparece la localidad deseada (Santa Cruz de Tenerife).
      https://maps.googleapis.com/maps/api/geocode/json?new_forward_geocoder=true&components=administrative_area:Anaga%7Clocality:Santa%20Cruz&key=YOUR_API_KEY
      
    • Cuando se usa el autocompletado de sitios para input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode, se muestra primero “Santa Cruz de Tenerife, Spain” y también aparecen otras ciudades, como “Santa Cruz de La Palma” (en otra isla) y “Santa Cruz, CA, United States”.
      https://maps.googleapis.com/maps/api/place/autocomplete/json?input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode&key=YOUR_API_KEY
      
    • Agrega strictbounds a la solicitud anterior de autocompletado de sitios para mostrar resultados que estén restringidos a la región especificada (“Anaga”).
      https://maps.googleapis.com/maps/api/place/autocomplete/json?input=santa+cruz&location=28.494168,-16.275751&radius=20000&types=geocode&strictbounds&key=YOUR_API_KEY
      

Enviar comentarios sobre…

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