Descripción general de la API de Map Management

La API de Map Management es una API de REST que puedes usar para administrar de manera programática tus recursos de diseño de mapas basado en Cloud. Con esta API, puedes definir el aspecto visual de tus mapas, administrar las identidades de los mapas y asociar estilos personalizados y conjuntos de datos con variantes de mapas específicas, todo sin usar la consola de Cloud.

La API de Map Management está diseñada para los desarrolladores que desean realizar una administración a gran escala de las configuraciones de mapas o integrar el diseño de mapas en sus propios flujos de trabajo automatizados y herramientas internas.

Recursos clave

  • StyleConfig: Contiene la representación JSON de un diseño de mapa. Esto define los colores, la visibilidad y la densidad de los componentes del mapa.
  • MapConfig: Representa una identidad de mapa única (ID de mapa). Actúa como un contenedor para los parámetros de configuración de diseño y las funciones, como el aumento de los lugares de interés o el aplanamiento de edificios.
  • MapContextConfig: Asocia un StyleConfig (y, de forma opcional, uno o más conjuntos de datos) con un MapVariants específico dentro de un MapConfig.

Canales de control de versiones de la API

La API de Map Management usa el control de versiones basado en canales para proporcionar una ruta clara desde las funciones experimentales hasta la disponibilidad general estable.

  • v2alpha (experimental): Contiene las funciones experimentales más recientes. Las funciones de este canal pueden cambiar sin previo aviso y no se recomiendan para su uso en producción.
  • v2beta (versión preliminar): Contiene funciones estables y que se están preparando para la disponibilidad general. Este canal es adecuado para la adopción temprana y las pruebas en entornos de preproducción.
  • v2 (disponibilidad general): Contiene funciones completamente compatibles y listas para producción.

La mayoría de las funciones de la versión 2 están disponibles en los extremos v2alpha y v2beta durante sus respectivas fases de lanzamiento. Para los usuarios nuevos, Google recomienda comenzar con el extremo v2beta.

Autenticación

Solo puedes usar OAuth 2.0 para autenticarte con la API de Map Management, que no admite claves de API. Para obtener más información, consulta Usa OAuth.

Limitaciones

  • Roles de desarrollador: Para usar la API de Map Management, debes tener los permisos de IAM necesarios para administrar los recursos de Google Maps Platform en tu proyecto de Google Cloud.
  • Alcance de los recursos: Esta API se enfoca en la administración de los recursos de diseño de mapas basado en Cloud. Es posible que otras configuraciones de Google Maps Platform aún requieran la consola de Cloud.

Costos

No se aplican cargos por usar la API de Map Management. Las llamadas a la API aparecen en la página Facturación de la consola de Cloud, pero los cargos serán de $0. Sin embargo, las solicitudes están restringidas de la siguiente manera:

  • 3 QPS (consultas por segundo)
  • 180 QPM (consultas por minuto) para un proyecto, que se actualizan cada minuto
  • 100,000 QPD (consultas por día) para un proyecto, que se actualizan cada día

Consulta Uso y facturación.