API de Places: Obtén una clave de API

Nota: El plan Premium de Google Maps Platform ya no está disponible para registros o clientes nuevos.

Para usar la API de Places debes tener una clave 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.

Con una clave de API para autenticar solicitudes, puedes hacer lo siguiente:

Obtén más información sobre los informes disponibles para los clientes del plan Premium.

Cómo crear claves de API

Debes tener al menos una clave de API asociada a tu proyecto.

Para obtener una clave de API, haz lo siguiente:

  1. Ve a Google Cloud Platform Console.
  2. Haz clic en el menú desplegable de proyectos y selecciona el proyecto que se creó cuando compraste el plan Premium. El nombre del proyecto comienza con Google Maps APIs for Business, Google Maps for Work o Google Maps.
  3. Nota: Para tener acceso completo a las funciones de su plan, los clientes Premium deben usar el proyecto asociado con su cuenta Premium. Cuando compraste tu licencia, recibiste el nombre de tu elemento Premium en el siguiente formato: gme-[company] & proj-[number] ([type]). Para asegurarte de utilizar el proyecto correcto, accede a la consola como el propietario del proyecto mediante console.cloud.google.com/project/number (reemplaza number por tu número de proyecto). Puedes ver el propietario del proyecto en tu carta de bienvenida.

  4. Haz clic en el botón de menú  y selecciona API y servicios > Credenciales.
  5. 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 (una string encriptada).
  6. Haz clic en Cerrar.
    La nueva clave de API aparecerá en la página Credenciales debajo de Claves de API.

Cómo agregar la clave de API a tu solicitud

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

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Cómo restringir las claves de API

La restricción de las claves de API agrega seguridad a tu aplicación, ya que garantiza que solo se realicen solicitudes autorizadas con tu clave de API. Te recomendamos que sigas las instrucciones si deseas configurar restricciones para tus claves de API. Para obtener más información, consulta Prácticas recomendadas relacionadas con las claves de API.

Para restringir una clave de API, sigue estos pasos:

  1. En GCP Console, en la página del selector de proyectos, elige o crea un proyecto de Google Cloud para el que desees agregar una clave de API.

    Ir a la página del selector de proyectos

  2. Ve a la página API y servicios > Credenciales.

    Ir a la página Credenciales

  3. Selecciona la clave de API para la que deseas establecer una restricción. Aparecerá la página de propiedades de la clave de API.
  4. 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.
      2. Especifica una dirección IPv4 o IPv6, o una subred con notación CIDR (p. ej., 192.168.0.0/22). Si necesitas ingresar otra entrada, aparecerá un cuadro nuevo cuando termines de agregar la entrada anterior.
    • Restricciones de API:
      1. Haz clic en Restringir clave.
      2. Selecciona API de Places en el menú desplegable Seleccionar API.
        (Si la API de Places no aparece en la lista, debes habilitarla).
  5. Para finalizar los cambios, haz clic en Guardar.

Solución de problemas de autenticación

Si tu solicitud no tiene el formato correcto o proporciona una firma no válida, la API de Places muestra un error HTTP 403 (Forbidden).

Para solucionar problemas relacionados con URL individuales, puedes usar la herramienta URL Signing Debugger. Este depurador te permitirá validar rápidamente una URL y la firma que generó tu aplicación.

Como alternativa, si los clientes del plan Premium desean solucionar problemas de URL individuales, pueden acceder al Portal de asistencia de Google Cloud y seleccionar Recursos > Herramientas en línea del plan Premium de Google Maps Platform > URL Signing Debugger para las API de imagen y servicio web.