Descripción general de la API de Geocoding

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 convierte 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 utilizar 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 en una dirección. Este servicio está diseñado para geocodificar direcciones estáticas predefinidas a fin de colocar 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 de los 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:

  • Geocoding: 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 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. Puedes usar las direcciones para una variedad de 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 esta API. 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 Devuelve dirección, componentes de dirección y tipos de dirección. Consulta los resultados en la guía Solicitud y respuesta de Geocoding.
  • JSON
  • XML
Geocodificación inversa Devuelve dirección, componentes de dirección y tipos de dirección. Consulta Respuestas de geocodificación inversa en la guía Solicitud y respuesta de geocodificación inversa.
Geocodificación de lugares Devuelve dirección, componentes de dirección y tipos de dirección. Consulta Respuestas de geocodificación inversa en la guía Solicitud y respuesta de geocodificación de sitios.

Cómo usar la API de Geocoding

1 Prepárate. Para comenzar, consulta 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 Parámetros de Geocoding para obtener más detalles.
3 Cómo probar 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 más cercana legible por humanos para 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 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 a tu propia app Puedes usar datos de geocodificación para obtener direcciones a partir de marcadores de mapas 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 mediante 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 basadas en la licencia Apache 2.0 que asisten a la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos