Configura la API de Geocoding

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

En este documento, se describen los pasos necesarios para comenzar a usar la API de Geocoding.

1. Cuenta y facturación Asegúrate de cumplir con los requisitos previos.

2. Habilita la API Habilita la API en tu proyecto de Google Cloud.

3. Realiza tu primera solicitud Configura una clave de API o OAuth para realizar una solicitud a la API autenticada.

Punto clave: Esta guía de configuración incluye el procedimiento para configurar una clave de API y crear un token de OAuth. Elige el procedimiento que se aplica a tu entorno de implementación.

Los productos de Google Maps Platform están protegidos contra el uso no autorizado, ya que requieren que las llamadas a la API incluyan una clave de API o un token de OAuth.

Clave de API Token de OAuth

Crea un token de OAuth

La API de Geocoding admite el uso de OAuth 2.0 para la autenticación. Google admite situaciones comunes de OAuth 2.0, como las de un servidor web.

En este documento, se describe cómo pasar un token de OAuth a la llamada a la API de Geocoding en tu entorno de desarrollo. Para obtener instrucciones sobre cómo usar OAuth en un entorno de producción, consulta Métodos de autenticación en Google.

Nota:

Si bien puedes usar las APIs de Google Maps directamente con solicitudes a la API al servidor, las bibliotecas cliente proporcionan simplificaciones que reducen de manera significativa la cantidad de código que debes escribir. Google Maps proporciona bibliotecas cliente para muchos lenguajes de programación, incluidos Go, Java, Node.js y Python.

Consulta Bibliotecas cliente de la API de Geocoding para obtener documentación y ejemplos.

Acerca de OAuth

Existen muchas formas de crear y administrar tokens de acceso con OAuth según tu entorno de implementación.

Por ejemplo, el sistema de OAuth 2.0 de Google admite interacciones de servidor a servidor, como las que se producen entre tu aplicación y un servicio de Google. Para este caso, necesitas una cuenta de servicio, que es una cuenta que pertenece a tu aplicación y no a un usuario final individual. Tu aplicación llama a las APIs de Google en nombre de la cuenta de servicio, por lo que los usuarios no están involucrados de manera directa. Para obtener más información sobre los métodos de autenticación, consulta Métodos de autenticación en Google.

También puedes usar la API de Geocoding como parte de una app para dispositivos móviles de Android o iOS. Para obtener información general sobre el uso de OAuth con la API de Geocoding, incluida la administración de tokens de acceso para diferentes entornos de implementación, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Acerca de los permisos de OAuth

Para usar OAuth con la API de Geocoding, el token de OAuth debe tener asignado el alcance correcto. La API de Geocoding admite los siguientes alcances:

• https://www.googleapis.com/auth/maps-platform.geocode — Se usa con todos los extremos de la API de Geocoding.
• https://www.googleapis.com/auth/maps-platform.geocode.address — Úsalo solo con GeocodeAddress para la geocodificación directa.
• https://www.googleapis.com/auth/maps-platform.geocode.location — Solo se usa con GeocodeLocation para la geocodificación inversa.
• https://www.googleapis.com/auth/maps-platform.geocode.place — Úsalo solo con GeocodePlace para la geocodificación de lugares.

También puedes usar el alcance general https://www.googleapis.com/auth/cloud-platform para todos los extremos de la API de Geocoding. Ese permiso es útil durante el desarrollo porque es el permiso predeterminado que se usa cuando se crean tokens con gcloud.

Ejemplo: Prueba las llamadas a la API de REST en tu entorno de desarrollo local

Si deseas probar la API de Geocoding con un token de OAuth, pero no tienes un entorno configurado para generar tokens, puedes usar el procedimiento de esta sección para realizar la llamada.

En este ejemplo, se describe cómo usar el token de OAuth proporcionado por las credenciales predeterminadas de la aplicación (ADC) para realizar la llamada. Si deseas obtener información sobre el uso de ADC para llamar a las APIs de Google con bibliotecas cliente, consulta Autentícate con bibliotecas cliente.

Nota: El siguiente procedimiento para realizar una llamada a la API de REST no está diseñado para usarse en un entorno de producción. Usa este procedimiento solo para un entorno de desarrollo o pruebas.

Requisitos previos

Antes de realizar una solicitud REST con ADC, usa Google Cloud CLI para proporcionar credenciales a ADC:

1. Instala e inicializa gcloud CLI

2. Ejecuta el siguiente comando gcloud en tu máquina local para crear tu archivo de credenciales:

   gcloud auth application-default login

3. Se muestra una pantalla de acceso. Después de acceder, tus credenciales se almacenan en el archivo de credenciales local que usa ADC.

Para obtener más información, consulta Configura ADC para un entorno de desarrollo local.

Haz una solicitud de REST

En este ejemplo, pasas dos encabezados de solicitud:

• Pasa el token de OAuth en el encabezado Authorization con el siguiente comando para generar el token:

  gcloud auth application-default print-access-token

  El token que se devuelve tiene un alcance de https://www.googleapis.com/auth/cloud-platform.

• Pasa el ID o el nombre de tu proyecto de Google Cloud que tiene habilitada la facturación en el encabezado X-Goog-User-Project.

En el siguiente ejemplo, se realiza una llamada a la API de Geocoding con un token de OAuth.

1. Edita el campo PROJECT_ID para pasar el ID de tu proyecto de Google Cloud.

   curl -X GET -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. Haz clic en el ícono de copiar en la muestra de código, , para copiar el comando curl.
3. Pega el comando en una ventana de la terminal y ejecútalo.

La respuesta es un objeto JSON:

Solución de problemas

Si tu solicitud muestra un mensaje de error sobre la compatibilidad de las credenciales del usuario final con la API, consulta Soluciona problemas de la configuración de ADC.