La API de Geocoding es un servicio que acepta un lugar como una dirección, 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.
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 para direcciones
- Direcciones para conjuntos de coordenadas de latitud y longitud
- Direcciones para IDs de lugar
Puedes controlar dónde aparecen los resultados y restringirlos 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 tanto la geocodificación como la geocodificación inversa:
- Geocodificación: Convierte direcciones, como "1600 Amphitheatre Parkway, Mountain View, CA", en coordenadas de latitud y longitud o IDs de lugar. Puedes usar estas coordenadas para colocar marcadores en un mapa, o bien para centrar o cambiar la posición del mapa dentro del marco de vista.
- Geocodificación inversa: Convierte coordenadas de latitud y longitud o un ID de lugar en una dirección legible por humanos. Puedes usar direcciones para una variedad de situaciones, como entregas o retiros.
En la siguiente demostración, se usa el servicio de Geocoding a través de la API de Maps JavaScript para mostrar cómo funciona la API de Geocoding. Abre el mapa en una pestaña independiente 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 devuelve cada método.
| Recursos de datos | Datos devueltos | Formato de devolución |
|---|---|---|
| Geocoding | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Resultados en la guía Solicitud y respuesta de geocodificación. |
|
| Geocodificación inversa | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Respuestas de geocodificación inversa en la guía de solicitudes y respuestas de geocodificación inversa. | |
| Geocodificación de lugares | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta Respuestas de geocodificación inversa en la guía de solicitudes y respuestas de geocodificación de lugares. |
Cómo usar la API de Geocoding
| 1 | Inicia la configuración. | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. |
| 2 | Prueba una solicitud de geocodificación | Una vez que tengas una clave de API, podrás 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. Consulta Parámetros de geocodificación para obtener más detalles. |
| 3 | Prueba una solicitud de geocodificación inversa | Proporciona las coordenadas de latitud y longitud junto con tu clave de API para obtener los componentes de la dirección legible por humanos más cercana a esa ubicación. Consulta Solicitudes de geocodificación inversa para obtener más detalles. |
| 4 | Comprende los conceptos básicos de las respuestas | Todos los métodos de la API de Geocoding devuelven 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 los datos de geocodificación para obtener direcciones a partir de marcadores de mapa o para proporcionar marcadores en un mapa según una dirección conocida. |
Bibliotecas cliente disponibles
Llama a esta API en el lenguaje que prefieras con una de las siguientes bibliotecas cliente:
- Cliente de Java para los servicios de Google Maps
- Cliente de Python para los servicios de Google Maps
- Cliente de Go para los servicios de Google Maps
- Cliente de Node.js para los servicios de Google Maps
Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto según la licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descárgalas de GitHub, donde también puedes encontrar instrucciones de instalación y código de muestra.
¿Qué sigue?
- Comienza a usar la API de Geocoding: Ve a Configura tu proyecto de Google Cloud.
- Comienza con solicitudes y respuestas de muestra: Consulta Solicitudes y respuestas de Geocoding.
- Sigue las prácticas recomendadas: Consulta las prácticas recomendadas para la geocodificación de direcciones.