Descripción general de la API de Geocoding

La API de Geocoding es un servicio que acepta un lugar como una dirección, las coordenadas de latitud y longitud o un ID de lugar. Convierte la dirección en coordenadas de latitud y longitud y un ID de lugar, o bien convierte las coordenadas de latitud y longitud o un ID de lugar en una dirección.

Por qué usar la API de Geocoding

Usa la API de Geocoding para sitios web o aplicaciones para dispositivos móviles cuando desees usar datos de geocodificación en mapas proporcionados por una de las APIs de Google Maps Platform. Con la API de Geocoding, puedes usar direcciones para colocar marcadores en un mapa o convertir un marcador de un mapa en una dirección. Este servicio está diseñado para geocodificar direcciones estáticas predefinidas para posicionar el contenido de la aplicación en un mapa.

Qué puedes hacer con la API de Geocoding

Puedes usar la API de Geocoding para obtener datos de geocodificación de una o más direcciones o lugares, incluidos los siguientes:

  • Coordenadas geográficas de las direcciones
  • Direcciones para conjuntos de coordenadas de latitud y longitud
  • Direcciones para IDs de lugar.

Puedes controlar dónde aparecen los resultados y limitarlos a una región, un condado o un código postal en particular.

Cómo funciona la API de Geocoding

La API de Geocoding realiza la geocodificación y la geocodificación inversa:

  • Geocoding: Convierte direcciones como "1600 Amphitheatre Parkway, Mountain View, CA" en coordenadas de latitud y longitud o en IDs de lugar. Puedes usar estas coordenadas para colocar marcadores en un mapa, o bien para centrar o cambiar la posición del mapa en el marco de la vista.
  • Geocodificación inversa: Convierte las coordenadas de latitud y longitud o un ID de lugar en una dirección legible por humanos. Puedes usar direcciones para distintas situaciones, como entregas o retiros.

En la siguiente demostración, se usa el servicio Geocoding mediante la API de Maps JavaScript para demostrar cómo funciona la API de Geocoding. Abre el mapa en otra pestaña para ver más opciones y detalles.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Geocoding junto con los datos que muestra cada extremo.

Recursos de datos Datos mostrados Formato de devolución
Geocoding Devuelve direcciones, componentes de dirección y tipos de direcciones. Consulta Resultados en la guía Solicitud y respuesta de Geocoding.
  • JSON
  • XML
Geocodificación inversa Devuelve direcciones, componentes de dirección y tipos de direcciones. Consulta Respuestas de geocodificación inversa en la guía Solicitud y respuesta de geocodificación inversa.
Geocodificación de lugares Devuelve direcciones, componentes de dirección y tipos de direcciones. Consulta Respuestas de geocodificación inversa en la guía Solicitud y respuesta de geocodificación de lugar.

Cómo usar la API de Geocoding

1 Prepárate. Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se siguen.
2 Prueba una solicitud de geocodificación Una vez que tengas una clave de API, puedes comenzar a probar la API de Geocoding directamente desde cURL o un navegador. Deberás proporcionar los parámetros de búsqueda correctos para las búsquedas de direcciones o componentes. Para obtener más información, consulta Parámetros de Geocoding.
3 Prueba una solicitud de geocodificación inversa Proporciona coordenadas de latitud y longitud junto con tu clave de API para obtener los componentes de la dirección más cercana legible por humanos a esa ubicación. Consulta Solicitudes de geocodificación inversa para obtener más información.
4 Comprende los conceptos básicos de las respuestas Todos los extremos de la API de Geocoding muestran los mismos datos en JSON o XML. Consulta Respuestas de Geocoding para obtener una explicación de los datos, los códigos de estado y los mensajes de error.
5 Incorpora datos de geocodificación en tu propia app. Puedes usar datos de geocodificación para obtener direcciones a partir de marcadores de mapa o para suministrar marcadores en un mapa basados en una dirección conocida.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que prefieras a través de una de las siguientes bibliotecas cliente:

Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto que cuentan con la asistencia de la comunidad según la licencia Apache 2.0. Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

¿Qué sigue?