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, Kartenidentitäten verwalten und benutzerdefinierte Stile und Datensätze bestimmten Kartenvarianten zuordnen – alles ohne Verwendung der Cloud Console.

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

Wichtige Ressourcen

  • StyleConfig: Enthält die JSON-Darstellung eines Kartenstils. Hier werden die Farben, Sichtbarkeit und Dichte der Kartenelemente 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 Vereinfachung von Gebäuden.
  • MapContextConfig: Verknüpft eine StyleConfig (und optional einen oder mehrere Datensätze) mit bestimmten MapVariants in einer MapConfig.

API-Versionierungskanäle

Die Map Management API verwendet eine kanalbasierte Versionsverwaltung, um einen klaren Pfad von experimentellen Funktionen zu stabilen, allgemein verfügbaren Funktionen zu bieten.

  • v2alpha (experimentell): Enthält die neuesten experimentellen Funktionen. Funktionen in diesem Kanal können ohne Vorankündigung geändert werden und werden nicht für die Produktion empfohlen.
  • v2beta (Vorschau): 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 Tests in Vorproduktionsumgebungen.
  • v2 (allgemeine Verfügbarkeit): Enthält vollständig unterstützte, produktionsreife Funktionen.

Die meisten v2-Funktionen sind während der jeweiligen Einführungsphasen sowohl über die Endpunkte v2alpha als auch v2beta verfügbar. Neuen Nutzern empfiehlt Google, mit dem Endpunkt v2beta zu beginnen.

Authentifizierung

Sie können sich nur mit OAuth 2.0 bei der Map Management API authentifizieren. API-Schlüssel werden nicht unterstützt. Weitere Informationen finden Sie unter OAuth verwenden.

Beschränkungen

  • Entwicklerrollen: Um die Map Management API verwenden zu können, benötigen Sie die erforderlichen IAM-Berechtigungen zum Verwalten von Google Maps Platform-Ressourcen in Ihrem Google Cloud-Projekt.
  • Ressourcenbereich: Diese API konzentriert sich auf die Verwaltung von cloudbasierten Karten stilressourcen. 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 auf der Abrechnungsseite in der Cloud Console angezeigt, die Kosten betragen jedoch 0 $. Anfragen sind jedoch wie folgt beschränkt:

  • 3 Abfragen pro Sekunde
  • 180 Abfragen pro Minute für ein Projekt, jede Minute aktualisiert
  • 100.000 Abfragen pro Tag für ein Projekt, täglich aktualisiert

Weitere Informationen finden Sie unter Nutzung und Abrechnung.