Comenzar

La API de Geocoding es un servicio que proporciona geocodificación convencional e inversa de direcciones.

La geocodificación es el proceso que convierte direcciones (como la dirección de una 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 direcciones legibles por humanos.

También puedes usar la API de Geocoding para buscar la dirección de un ID de lugar específico.

Ejemplo de solicitud y respuesta

Puedes acceder a la API de Geocoding a través de una interfaz HTTP. Los siguientes son 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 longitud de "1600 Amphitheatre Parkway, Mountain View, CA" y se 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 si quieres obtener más información sobre cómo crear URLs de solicitud 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" : [
      {
         "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 y 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). En la respuesta, se incluye una dirección legible por humanos para la ubicación de latitud y longitud.

Consulta la guía para desarrolladores si quieres obtener más información sobre cómo crear URLs de solicitudes de geocodificación inversa, los parámetros disponibles y cómo 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 facilitan el desarrollo con las APIs de servicio web de Google Maps, ya que proporcionan implementaciones nativas simples de tareas comunes, como autenticación, regulación de solicitudes y reintento automático. La API de Geocoding está disponible en los clientes de Java, 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 habilitarla y obtener las credenciales de autenticación correspondientes. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.

Cuotas y precios

Consulta la página 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 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 para ver demostraciones, ejemplos, parámetros disponibles, códigos de estado, mensajes de error y otros detalles adicionales.

En la guía para desarrolladores de la API de Geocoding, se describe el servicio web de la API de Geocoding. Está dirigida a desarrolladores de sitios web y dispositivos móviles que deseen usar datos de geocodificación en mapas proporcionados por una de las APIs de Google Maps Platform.