Leitfaden und Beispiele für die Map Management API

Mit der Map Management API können Sie Ihre Ressourcen für das cloudbasierte Gestalten von Karteninhalten programmatisch über die Endpunkte v2alpha (experimentell) und v2beta (Vorschau) hinweg verwalten.

Zusammenfassung der Vorgänge

So visualisieren Sie eine benutzerdefinierte Karte mit der Map Management API:

  1. StyleConfig erstellen: Definieren Sie das visuelle Erscheinungsbild Ihrer Karte mit einer JSON Darstellung der Einstellungen für Farben, Sichtbarkeit und Dichte.
  2. MapConfig erstellen: Legen Sie eine eindeutige Karten-ID fest, die als Container für die Identität und die allgemeinen Funktionen Ihrer Karte dient.
  3. Mit einer MapContextConfig verknüpfen: Verknüpfen Sie Ihre StyleConfig (und optionale Datasets) mit bestimmten Kartenvarianten (z. B. ROADMAP oder SATELLITE) in Ihrer MapConfig.

Standardverhalten

Beachten Sie bei der Verwendung der v2-Endpunkte die folgenden Standardverhaltensweisen:

  • Kartentyp: Der Standardtyp für das Kartenrendering ist RASTER. Wenn Sie vektorbasierte Karten verwenden möchten, müssen Sie map_type in Ihrer MapConfig explizit auf VECTOR setzen.
  • Kartenvariante: Wenn beim Erstellen einer MapContextConfig keine map_variants angegeben werden, wird die Konfiguration standardmäßig nur auf die ROADMAP Variante angewendet.
  • Basisstil: Wenn ein json_style_sheet leer ist oder in einer StyleConfig nicht angegeben wird, wird die standardmäßige, nicht formatierte Google-Basiskarte verwendet.

Mit StyleConfigs arbeiten

Eine StyleConfig enthält die JSON-basierten Stildefinitionen.

StyleConfig erstellen

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

StyleConfigs auflisten

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

Mit MapConfigs arbeiten

Eine MapConfig definiert die Identität und den wichtigsten Renderingtyp einer Karte.

MapConfig erstellen

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

Mit MapContextConfigs arbeiten

Eine MapContextConfig verknüpft Stile mit einer MapConfig.

MapContextConfig erstellen

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

Fehler

  • PERMISSION_DENIED: Die Anfrage enthält nicht genügend IAM-Berechtigungen oder die API ist für das Projekt nicht aktiviert.
  • NOT_FOUND: Die angegebene Ressource (Projekt, MapConfig oder StyleConfig) ist nicht vorhanden.
  • INVALID_ARGUMENT: Der Anfragetext ist fehlerhaft oder enthält ungültige Feldwerte.