Map Management API – Übersicht

Die Map Management API ist eine RESTful API, mit der Sie Ihre cloudbasierten Ressourcen für das 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 das Gestalten von Karteninhalten 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: Ordnet eine StyleConfig (und optional einen oder mehrere Datensätze) bestimmten MapVariants innerhalb einer MapConfig zu.

API-Versionierungskanäle

Die Map Management API verwendet eine kanalbasierte Versionierung, um einen klaren Weg 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 Ressourcen für das Gestalten von Karteninhalten. Für andere Google Maps Platform-Konfigurationen ist möglicherweise weiterhin die Cloud Console erforderlich.

Kosten

Die Verwendung der Map Management API ist kostenlos. API-Aufrufe werden auf der Abrechnungsseite in der Cloud Console angezeigt, die Kosten betragen jedoch 0 $. Anfragen sind jedoch wie folgt eingeschränkt:

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

Weitere Informationen finden Sie unter Nutzung und Abrechnung.