Map Management API – Übersicht

Die Map Management API ist eine RESTful API, mit der Sie Ihre Ressourcen für das cloudbasierte Gestalten von Karteninhalten programmatisch verwalten können. Mit dieser API können Sie das visuelle Erscheinungsbild Ihrer Karten definieren, Karten-IDs verwalten und benutzerdefinierte Stile und Datasets mit bestimmten Kartenvarianten verknüpfen – ganz ohne die Cloud Console.

Die Map Management API ist für Entwickler gedacht, die Kartenkonfigurationen in großem Umfang verwalten oder Kartenstile in ihre eigenen automatisierten Workflows und internen Tools einbinden möchten.

Wichtige Ressourcen

  • StyleConfig: Enthält die JSON-Darstellung eines Kartenstils. Damit werden die Farben, die Sichtbarkeit und die Dichte von Kartenelementen definiert.
  • MapConfig: Stellt eine eindeutige Kartenidentität (Karten-ID) dar. Sie dient als Container für Stileinstellungen und Funktionen wie die Hervorhebung von POIs oder die Abflachung von Gebäuden.
  • MapContextConfig: Verknüpft eine StyleConfig (und optional ein oder mehrere Datasets) mit bestimmten MapVariants innerhalb einer MapConfig.

API-Versionskanäle

Die Map Management API verwendet eine kanalbasierte Versionsverwaltung, um einen klaren Weg von experimentellen Funktionen bis hin zur stabilen, allgemeinen Verfügbarkeit zu bieten.

  • v2alpha (experimentell): Enthält die neuesten experimentellen Funktionen. Die Funktionen in diesem Kanal können sich ohne Vorankündigung ändern und werden nicht für den produktiven Einsatz empfohlen.
  • v2beta (Vorabversion): Enthält Funktionen, die stabil sind und für die allgemeine Verfügbarkeit vorbereitet werden. Dieser Kanal eignet sich für die frühe Einführung und das Testen in Vorproduktionsumgebungen.
  • v2 (Allgemeine Verfügbarkeit): Enthält vollständig unterstützte, produktionsreife Funktionen.

Die meisten v2-Funktionen sind während der jeweiligen Roll-out-Phasen sowohl über den v2alpha- als auch über den v2beta-Endpunkt verfügbar. Google empfiehlt neuen Nutzern, mit dem v2beta-Endpunkt zu beginnen.

Authentifizierung

Sie können nur OAuth 2.0 für die Authentifizierung bei der Map Management API verwenden, da diese keine API-Schlüssel unterstützt. Weitere Informationen finden Sie unter OAuth verwenden.

Beschränkungen

  • Entwicklerrollen: Wenn Sie die Map Management API verwenden möchten, benötigen Sie die erforderlichen IAM-Berechtigungen, um Google Maps Platform-Ressourcen in Ihrem Google Cloud-Projekt zu verwalten.
  • Ressourcenbereich: Diese API konzentriert sich auf die Verwaltung von Ressourcen für das cloudbasierte Gestalten von Karteninhalten. Für andere Google Maps Platform-Konfigurationen ist möglicherweise weiterhin die Cloud Console erforderlich.

Kosten

Für die Verwendung der Map Management API fallen keine Gebühren an. API-Aufrufe werden in der Cloud Console auf der Seite „Abrechnung“ angezeigt, die Kosten betragen jedoch 0 $. Anfragen sind jedoch so eingeschränkt:

  • 3 Abfragen pro Sekunde
  • 180 Anfragen pro Minute für ein Projekt, die jede Minute aktualisiert werden
  • 100.000 Anfragen pro Tag und Projekt, die jeden Tag aktualisiert werden

Weitere Informationen finden Sie unter Nutzung und Abrechnung.