La API de Map Management es una API de REST que puedes usar para administrar de forma programática tus recursos de diseño de mapas basados en Cloud. Con esta API, puedes definir el aspecto visual de tus mapas, administrar las identidades de los mapas y asociar diseños y conjuntos de datos personalizados 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 administrar a gran escala 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 la configuración de diseño y las funciones, como el refuerzo de POI o el aplanamiento de edificios.
- MapContextConfig: Asocia un
StyleConfig(y, de manera opcional, uno o más conjuntos de datos) conMapVariantsespecíficos dentro de unMapConfig.
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 el uso en la producción.
- v2beta (versión preliminar): Contiene funciones estables que se están preparando para la disponibilidad general. Este canal es adecuado para la adopción anticipada y las pruebas en entornos de preproducción.
- v2 (disponibilidad general): Contiene funciones totalmente 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 en 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 del recurso: Esta API se enfoca en la administración de recursos de Map Styling basados 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 Cloud Console, pero los cargos serán de USD 0. Sin embargo, las solicitudes están sujetas a las siguientes restricciones:
- 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 todos los días
Consulta Uso y facturación.