Présentation de l'API Map Management

L'API Map Management est une API RESTful que vous pouvez utiliser pour gérer de manière programmatique vos ressources de styles de cartes basés dans le cloud. Cette API vous permet de définir l'apparence visuelle de vos cartes, de gérer les identités de carte et d'associer des styles et des ensembles de données personnalisés à des variantes de carte spécifiques, le tout sans utiliser la console Cloud.

L'API Map Management est conçue pour les développeurs qui souhaitent gérer des configurations de cartes à grande échelle ou intégrer le style de carte dans leurs propres workflows automatisés et outils internes.

Principales ressources

  • StyleConfig : contient la représentation JSON d'un style de carte. Cela définit les couleurs, la visibilité et la densité des éléments cartographiques.
  • MapConfig : représente une identité de carte unique (ID de carte). Il sert de conteneur pour les paramètres de style et les fonctionnalités telles que la mise en avant des points d'intérêt ou l'aplatissement des bâtiments.
  • MapContextConfig : associe un StyleConfig (et éventuellement un ou plusieurs ensembles de données) à des MapVariants spécifiques dans un MapConfig.

Canaux de gestion des versions de l'API

L'API Map Management utilise la gestion des versions basée sur les canaux pour fournir un chemin clair des fonctionnalités expérimentales à la disponibilité générale stable.

  • v2alpha (expérimental) : contient les dernières fonctionnalités expérimentales. Les fonctionnalités de ce canal peuvent être modifiées sans préavis et ne sont pas recommandées pour une utilisation en production.
  • v2beta (Preview) : contient des fonctionnalités stables en cours de préparation pour la disponibilité générale. Ce canal convient à l'adoption précoce et aux tests dans les environnements de préproduction.
  • v2 (disponibilité générale) : contient des fonctionnalités entièrement compatibles et prêtes pour la production.

La plupart des fonctionnalités de la version 2 sont disponibles pour les points de terminaison v2alpha et v2beta pendant leurs phases de déploiement respectives. Pour les nouveaux utilisateurs, Google recommande de commencer par le point de terminaison v2beta.

Authentification

Vous ne pouvez utiliser que OAuth 2.0 pour vous authentifier auprès de l'API Map Management, qui n'est pas compatible avec les clés API. Pour en savoir plus, consultez Utiliser OAuth.

Limites

  • Rôles de développeur : pour utiliser l'API Map Management, vous devez disposer des autorisations IAM nécessaires pour gérer les ressources Google Maps Platform dans votre projet Google Cloud.
  • Champ d'application des ressources : cette API se concentre sur la gestion des ressources de style de carte basé sur le cloud. D'autres configurations Google Maps Platform peuvent encore nécessiter la console Cloud.

Coûts

L'utilisation de l'API Map Management est sans frais. Les appels d'API s'affichent sur la page "Facturation" de la console Cloud, mais les frais sont de 0 $. Toutefois, les requêtes sont limitées comme suit :

  • 3 RPS (requêtes par seconde)
  • 180 RPM (requêtes par minute) pour un projet, actualisées chaque minute
  • 100 000 RPJ (requêtes par jour) pour un projet, actualisées chaque jour

Pour en savoir plus, consultez Utilisation et facturation.