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 en 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:
- Son las coordenadas geográficas de las direcciones.
- Son las direcciones de los conjuntos de coordenadas de latitud y longitud.
- Son las direcciones de los 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 reposicionar el mapa dentro del marco de la 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, incluidas las entregas o los retiros.
En la siguiente demostración, se usa el servicio 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 separada 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 extremo.
| 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 la sección Resultados en la guía de Solicitud y respuesta de Geocoding. |
|
| Geocodificación inversa | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta las respuestas de geocodificación inversa en la guía de solicitudes y respuestas de geocodificación inversa. | |
| Geocoding de lugares | Devuelve la dirección, los componentes de la dirección y los tipos de dirección. Consulta las 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 | Configura tu cuenta. | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. |
| 2 | Cómo probar 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. Consulta los 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 dirección 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 | Conceptos básicos sobre las respuestas | Todos los extremos de la API de Geocoding devuelven los mismos datos en formato 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 de los marcadores del mapa o para proporcionar marcadores en un mapa según una dirección conocida. |
Bibliotecas cliente disponibles
Llama a esta API en el idioma que elijas a través de una de las siguientes bibliotecas cliente:
- Biblioteca cliente de Java para los servicios de Google Maps
- Cliente de Python para los servicios de Google Maps
- Biblioteca 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 cliente 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 encontrarás 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 a usar solicitudes y respuestas de muestra: Ve a Solicitudes y respuestas de Geocoding.
- Sigue las prácticas recomendadas: Consulta Prácticas recomendadas sobre la geocodificación de direcciones.