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 die visuelle Darstellung Ihrer Karten definieren, Kartenidentitäten verwalten und benutzerdefinierte Stile und Datasets bestimmten Kartenvarianten zuordnen – alles ohne Verwendung der 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 das Hervorheben von POIs oder das Abflachen von Gebäuden.
  • MapContextConfig: Ordnet einem StyleConfig (und optional einem oder mehreren Datasets) bestimmte MapVariants in einem MapConfig zu.

API-Versionierungschannels

Die Map Management API verwendet die channelbasierte 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 Channel 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 auf die allgemeine Verfügbarkeit vorbereitet werden. Dieser Kanal eignet sich für die frühe Einführung und für Tests in Vorproduktionsumgebungen.
  • Version 2 (allgemeine Verfügbarkeit): Enthält vollständig unterstützte, produktionsreife Funktionen.

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

Authentifizierung

Sie können nur OAuth 2.0 zur Authentifizierung bei der Map Management API verwenden, die 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 Cloud-basierten Ressourcen für das Kartenstyling. 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 Seite „Abrechnung“ in der Cloud Console angezeigt, die Kosten betragen jedoch 0 $. Anfragen unterliegen jedoch den folgenden Einschränkungen:

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

Weitere Informationen finden Sie unter Nutzung und Abrechnung.