La API de Geocoding v4 es un servicio que proporciona geocodificación, geocodificación inversa de direcciones y IDs de lugar, y también información de destino.
La geocodificación es el proceso de convertir direcciones (como una dirección de la calle) en coordenadas geográficas (como latitud y longitud), que puedes usar para colocar marcadores en un mapa o posicionar el mapa.
La geocodificación inversa es el proceso de convertir coordenadas geográficas en una dirección legible por humanos.
También puedes usar la API de Geocoding para encontrar la dirección de un ID de lugar determinado.
Ejemplo de solicitud y respuesta
Accedes a la API de Geocoding a través de una interfaz HTTP. A continuación, se incluyen ejemplos de solicitudes de geocodificación y geocodificación inversa.
Solicitud y respuesta de geocodificación (búsqueda de latitud y longitud)
En el siguiente ejemplo, se solicita la latitud y la longitud de "1600 Amphitheatre Parkway, Mountain View, CA" y se especifica que el resultado debe estar en formato JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
Para probarlo, ingresa la URL en tu navegador web (asegúrate de reemplazar YOUR_API_KEY por tu clave de API real).
En la respuesta se incluyen la latitud y longitud de la dirección.
Consulta la guía para desarrolladores para obtener más información sobre cómo compilar URLs de solicitudes de geocodificación, los parámetros disponibles y cómo comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta de geocodificación, en JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
Solicitud y respuesta de geocodificación inversa (búsqueda de dirección)
En el siguiente ejemplo, se solicita la dirección correspondiente a una latitud y longitud determinadas en Brooklyn, Nueva York, EE.UU. Se especifica que la salida debe tener un formato JSON.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYPara probarlo, ingresa la URL en tu navegador web (asegúrate de reemplazar "YOUR_API_KEY" por tu clave de API real). La respuesta incluye una dirección legible por humanos para la ubicación de latitud y longitud.
Consulta la guía para desarrolladores para obtener más información sobre cómo compilar URLs de solicitudes de geocodificación inversa, parámetros disponibles y comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta de geocodificación inversa, en JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
Autenticación, cuotas, precios y políticas
Autenticación
Para usar la API de Geocoding, primero debes habilitarla y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.
Cuotas y precios
Revisa la página de uso y facturación para obtener detalles sobre las cuotas y los precios establecidos para la API de Geocoding.
Políticas
El uso de la API de Geocoding debe cumplir con las políticas de la API.