Usa claves de API con la API de Maps Static

Los productos de Google Maps Platform están protegidos contra un uso no autorizado porque restringen las llamadas a la API a aquellas que proporcionan credenciales válidas de autenticación. Estas credenciales se indican como una clave de API, es decir, una string alfanumérica única que asocia tu cuenta de facturación de Google con tu proyecto y con la API o el SDK específicos.

En esta guía, se muestra cómo crear, restringir y usar tu clave de API en Google Maps Platform.

Antes de comenzar

Para comenzar a utilizar la API de Maps Static, debes tener un proyecto con una cuenta de facturación y la API de Maps Static habilitada. Si deseas obtener más información, consulta Set up in Cloud Console.

Cómo crear claves de API

La clave de API es un identificador único que se utiliza para autenticar solicitudes asociadas a tu proyecto con fines de uso y facturación. Debes tener, al menos, una clave de API asociada a tu proyecto.

Para crear una clave de API, sigue estos pasos:

Consola

1. Ve a la página Google Maps Platform > Credenciales.

   Ir a la página Credenciales

2. En la página Credenciales, haz clic en Crear credenciales > Clave de API.
   El diálogo Se creó la clave de API mostrará la clave de API que acabas de crear.
3. Haz clic en Cerrar.
   La nueva clave de API aparecerá en la página Credenciales debajo de Claves de API.
   (Recuerda restringir la clave de API antes de utilizarla en producción).

SDK de Cloud

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

• gcloud alpha services api-keys create

Cómo restringir las claves de API

Google recomienda que restrinjas las claves de API limitando su uso solo a aquellas APIs que sean necesarias para tu aplicación. La restricción de las claves de API agrega seguridad a tu aplicación, ya que la protege de solicitudes no autorizadas. Para obtener más información, consulta Prácticas recomendadas sobre la seguridad de la API.

Cuando se restringe una clave de API en la consola de Cloud, las restricciones de aplicaciones anulan todas las APIs habilitadas en las restricciones de API. Si deseas seguir las prácticas recomendadas, crea una clave de API independiente para cada app y cada plataforma en la que dicha app esté disponible.

Además de restringir tus claves de API, debes firmar solicitudes para esta API. Para obtener más información, consulta Prácticas recomendadas sobre la seguridad de la API.

Para restringir una clave de API, sigue estos pasos:

Consola

1. Ve a la página Google Maps Platform > Credenciales.

   Ir a la página Credenciales

2. Selecciona la clave de API para la que deseas establecer una restricción. Aparecerá la página de propiedades de la clave de API.
3. En Restricciones de clave, establece las siguientes restricciones:
• Restricciones de aplicaciones:
1. Para aceptar las solicitudes de la lista de direcciones IP de servidor web que proporcionas, selecciona Direcciones IP (servidores web, trabajos cron, etc.) en la lista de Restricciones de aplicaciones. Especifica una o más direcciones IPv4 o IPv6, o bien una subred con notación CIDR. Las direcciones IP deben coincidir con la dirección de origen que observan los servidores de Google Maps Platform. Si usas la traducción de direcciones de red (NAT), por lo general, esto correspondería a la dirección IP pública de tu máquina.
• Restricciones de API:
1. Haz clic en Restringir clave.
2. Selecciona API de Maps Static en el menú desplegable Seleccionar API. Si la API de Maps Static no aparece en la lista, deberás enable.
4. Para finalizar los cambios, haz clic en Guardar.
   

SDK de Cloud

Enumera las claves existentes.

gcloud services api-keys list --project="PROJECT"

Borra las restricciones que existen sobre la clave existente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Establece restricciones nuevas sobre la clave existente.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="static-maps-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Cómo agregar la clave de API a tu solicitud

Debes incluir una clave de API con cada solicitud a la API de Maps Static. En el siguiente ejemplo, reemplaza YOUR_API_KEY por tu clave de API.

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&zoom=12&size=400x400&key=YOUR_API_KEY

Se requiere HTTPS para las solicitudes que usan una clave de API.

Nota: Cuando utilice servicios web, todos los caracteres especiales incluidos en los parámetros deben estar codificados para URL. Las URL deben estar correctamente codificadas para ser válidas y tienen una limitación de 2048 caracteres para todos los servicios web. Ten en cuenta este límite cuando construyas tus URLs, ya que los distintos navegadores, proxies y servidores también pueden tener límites de caracteres diferentes.

Próximos pasos

Las solicitudes a la API de Maps Static también deben usar una firma digital.