Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps Geocoding API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps Geocoding API
  3. Crear claves correspondientes
Continuar

Primeros pasos

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

Este servicio también está disponible como parte de la Google Maps JavaScript API de cliente o para el uso de servidor con Java Client, Python Client, Go Client y Node.js Client for Google Maps Services.

La geocodificación es el proceso que convierte direcciones (como la dirección de una calle) en coordenadas geográficas (latitud y longitud) que puedes usar para disponer marcadores en un mapa o posicionar el mapa.

La geocodificación inversa es el proceso de conversión de coordenadas geográficas en direcciones en lenguaje natural. El servicio de geocodificación inversa Google Maps Geocoding API también te permite buscar la dirección por un id. de sitio determinado.

Ejemplo de solicitud y respuesta

Puedes acceder a Google Maps Geocoding API a través de una interfaz HTTP. A continuación, se proporcionan 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 se especifica que la salida debe tener formato JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

Puedes probar esto ingresando 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 del desarrollador para obtener más información sobre la creación de URL de solicitud de geocodificación, los parámetros disponibles y la forma en que se interpreta 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 Pkwy",
               "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 Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "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, Estados Unidos. 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

Puedes probar esto ingresando la URL en tu navegador web (asegúrate de reemplazar “YOUR_API_KEY” por tu clave de API real). En la respuesta se incluye un lenguaje natural para la dirección de latitud y longitud.

Consulta la guía del desarrollador para obtener más información sobre la creación de URL de solicitud de geocodificación inversa, los parámetros disponibles y la forma en que se interpreta la respuesta.

A continuación, se muestra un ejemplo de respuesta de geocodificación inversa, en JSON:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "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" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "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" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

Comienza a realizar codificaciones con nuestras bibliotecas de cliente

Las bibliotecas de cliente facilitan el desarrollo con las API de Google Maps para servicio web al proporcionar implementaciones nativas simples de tareas comunes, como la autenticación, las restricciones de solicitudes y el reintento automático. La Google Maps Geocoding API se encuentra disponible en Java Client, Python Client, Go Client y Node.js Client for Google Maps Services.

Autenticación, cuotas y políticas

Activar la API y obtener una clave de API

Para usar la Google Maps Geocoding API, primero debes activar la API en la Google API Console y obtener las credenciales de autenticación correspondientes. Debes proporcionar una clave de API en cada solicitud (o un ID de cliente si tienes un plan premium).

Haz clic en el botón que aparece a continuación para realizar un proceso en el que podrás:

  1. Crear o seleccionar un proyecto
  2. Habilitar la API
  3. Obtén una clave de API
Obtén una clave

Obtén más información sobre las credenciales de autenticación.

Cuotas

Consulta la página de límites de uso para obtener información detallada sobre las cuotas establecidas para Google Maps Geocoding API.

Políticas

El uso de la Google Maps Geocoding API debe cumplir con las políticas de API.

Más información

Puedes realizar más acciones con la Geocoding API. Consulta la guía del desarrollador de la Geocoding API para ver demostraciones, ejemplos, parámetros disponibles, códigos de estado, mensajes de error y otros aspectos adicionales.

Enviar comentarios sobre...

Google Maps Geocoding API
Google Maps Geocoding API
Si necesitas ayuda, visita nuestra página de asistencia.