La API de Geocoding es un servicio que ofrece geocodificación convencional e inversa de direcciones.
La geocodificación es el proceso de conversión de direcciones (como una dirección). en coordenadas geográficas (como latitud y longitud) que puedes usar para colocar marcadores o ubicarlo en un mapa.
La geocodificación inversa es el proceso de conversión de coordenadas geográficas en una dirección legible por humanos.
También puedes usar la API de Geocoding para buscar la dirección de una el ID de lugar especificado.
Ejemplo de solicitud y respuesta
Puedes acceder a la API de Geocoding a través de una interfaz HTTP. Siguiendo son ejemplos de solicitudes de geocodificación convencional e inversa.
Solicitud y respuesta de geocodificación (búsqueda de latitud y longitud)
En el siguiente ejemplo, se solicita la latitud y longitud de “1600 Amphitheatre” Parkway, Mountain View, CA", y especifica que el resultado debe estar en formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Para probar esto, 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 crear URLs de solicitudes de geocodificación parámetros disponibles y comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta de geocodificación, en JSON:
{
"results" : [
{
"address_components" : [
{
"long_name" : "1600",
"short_name" : "1600",
"types" : [ "street_number" ]
},
{
"long_name" : "Amphitheatre Parkway",
"short_name" : "Amphitheatre Pkwy",
"types" : [ "route" ]
},
{
"long_name" : "Mountain View",
"short_name" : "Mountain View",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Clara County",
"short_name" : "Santa Clara County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "California",
"short_name" : "CA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "94043",
"short_name" : "94043",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
"geometry" : {
"location" : {
"lat" : 37.4267861,
"lng" : -122.0806032
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 37.4281350802915,
"lng" : -122.0792542197085
},
"southwest" : {
"lat" : 37.4254371197085,
"lng" : -122.0819521802915
}
}
},
"place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
"plus_code" : {
"compound_code" : "CWC8+R3 Mountain View, California, United States",
"global_code" : "849VCWC8+R3"
},
"types" : [ "street_address" ]
}
],
"status" : "OK"
}
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 o longitud determinadas en Brooklyn, NY, EE.UU. Se especifica que la salida debe tener un formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
Para probar esto, 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 sobre la latitud y la longitud ubicación.
Consulta la guía para desarrolladores para obtener más información crear URLs de solicitudes de geocodificación inversa y parámetros disponibles y comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta de geocodificación inversa, en JSON:
{
"plus_code" : {
"compound_code" : "P27Q+MC New York, NY, USA",
"global_code" : "87G8P27Q+MC"
},
"results" : [
{
"address_components" : [
{
"long_name" : "279",
"short_name" : "279",
"types" : [ "street_number" ]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" : [ "route" ]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" : [ "neighborhood", "political" ]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" : [ "political", "sublocality", "sublocality_level_1" ]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" : {
"location" : {
"lat" : 40.7142484,
"lng" : -73.9614103
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 40.71559738029149,
"lng" : -73.9600613197085
},
"southwest" : {
"lat" : 40.71289941970849,
"lng" : -73.96275928029151
}
}
},
"place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
"plus_code" : {
"compound_code" : "P27Q+MC Brooklyn, New York, United States",
"global_code" : "87G8P27Q+MC"
},
"types" : [
"bakery",
"cafe",
"establishment",
"food",
"point_of_interest",
"store"
]
},
... Additional results truncated in this example[] ...
],
"status" : "OK"
}
Comienza a realizar codificaciones con nuestras bibliotecas de cliente
Las bibliotecas cliente desarrollar con las Web Service API de Google Maps es más fácil al brindar implementaciones nativas de tareas comunes, como la autenticación, y el reintento automático. La API de Geocoding está disponible en la Java Client, Python, Go y Node.js para los servicios de Google Maps
Autenticación, cuotas, precios y políticas
Autenticación
Para usar la API de Geocoding, primero debes habilitar la API y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Comienza a utilizar Google Maps Platform.
Cuotas y precios
Revisa el uso y la 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 las APIs
Más información
Puedes realizar más acciones con la API de Geocoding. Consulta la Guía para desarrolladores sobre la API de Geocoding a fin de obtener demostraciones adicionales. ejemplos, parámetros disponibles, códigos de estado y mensajes de error, y otros detalles.
El En la guía para desarrolladores sobre la API de Geocoding, Servicio web de la API de Geocoding. Está destinado a desarrolladores de sitios web y dispositivos móviles. que desean usar datos de geocodificación en mapas proporcionados por una plataforma de APIs