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 quieras usar los datos de geocodificación en mapas proporcionados por una de las API 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 y predefinidas a fin de ubicar el contenido de la aplicación en un mapa.

Qué puedes hacer con la API de Geocoding

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

  • Coordenadas geográficas para las 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, condado o 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:

  • 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 vista.
  • Geocodificación inversa: Convierte las coordenadas de latitud y longitud o un ID de lugar en una dirección en lenguaje natural. Puedes usar direcciones para diversas 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 demostrar cómo funciona la API de Geocoding. Abre el mapa en una pestaña aparte 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 Muestra la dirección, los componentes de la dirección y los tipos de dirección. Consulta los resultados en la guía Solicitud y respuesta de geocodificación.
  • JSON
  • XML
Geocodificación inversa Muestra 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 Solicitud y respuesta de geocodificación inversa.
Geocodificación del lugar Muestra 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 Solicitud y respuesta de geocodificación de Places.

Cómo usar la API de Geocoding

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

Bibliotecas cliente disponibles

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

El cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto compatibles con la comunidad en virtud de la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos