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 personnalisés et des ensembles de données à 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 à grande échelle des configurations de cartes ou intégrer des styles de cartes dans leurs propres workflows automatisés et outils internes.

Principales ressources

  • StyleConfig : contient la représentation JSON d'un style de carte. Il 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 l'amélioration des POI 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 entre les fonctionnalités expérimentales et la disponibilité générale stable.

  • v2alpha (expérimental) : contient les dernières fonctionnalités expérimentales. Les fonctionnalités de cette version 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 est adapté à l'adoption anticipée 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 v2 sont disponibles sur 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 pouvez uniquement utiliser 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 styles de cartes basés dans le cloud. D'autres configurations Google Maps Platform peuvent toujours nécessiter la console Cloud.

Coûts

L'utilisation de l'API Map Management n'implique aucuns frais. Les appels d'API apparaissent 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 requêtes par jour pour un projet, actualisées chaque jour

Consultez Utilisation et facturation.