Przewodnik i przykłady interfejsu Map Management API

Za pomocą interfejsu API zarządzania mapami możesz programowo zarządzać zasobami definiowania stylów map w Google Cloud zarówno w przypadku punktów końcowych v2alpha (eksperymentalnych), jak i v2beta (wersja zapoznawcza).

Podsumowanie operacji

Aby wizualizować mapę niestandardową za pomocą interfejsu API zarządzania Google Analytics, wykonaj te główne czynności:

  1. Utwórz StyleConfig: zdefiniuj wygląd mapy za pomocą reprezentacji JSON ustawień kolorów, widoczności i gęstości.
  2. Utwórz MapConfig: utwórz unikalny identyfikator mapy, który będzie kontenerem tożsamości mapy i jej funkcji wysokiego poziomu.
  3. Powiąż je z MapContextConfig: połącz StyleConfig (i opcjonalne zbiory danych) z określonymi wariantami mapy (np. ROADMAP lub SATELLITE) w ramach MapConfig.

Działania domyślne

Podczas korzystania z punktów końcowych w wersji 2 pamiętaj o tych działaniach domyślnych:

  • Typ mapy: domyślny typ renderowania mapy to RASTER. Aby korzystać z map wektorowych, musisz wyraźnie ustawić map_type na VECTOR w MapConfig.
  • Wariant mapy: jeśli podczas tworzenia MapContextConfig nie określono żadnych map_variants, konfiguracja zostanie domyślnie zastosowana tylko do wariantu ROADMAP.
  • Styl podstawowy: jeśli json_style_sheet jest pusta lub nie została podana w StyleConfig, zostanie użyta domyślna mapa bazowa Google bez stylu.

Praca z StyleConfig

Element StyleConfig zawiera definicje stylu oparte na formacie JSON.

Tworzenie StyleConfig

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}]}]"
}'

Wyświetlanie listy StyleConfig

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

Praca z MapConfig

Element MapConfig określa tożsamość i podstawowy typ renderowania mapy.

Tworzenie MapConfig

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"
}'

Praca z MapContextConfig

Element MapContextConfig łączy styl z MapConfig.

Tworzenie MapContextConfig

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"]
}'

Błędy

  • PERMISSION_DENIED: żądanie nie ma wystarczających uprawnień IAM lub w projekcie nie jest włączony interfejs API.
  • NOT_FOUND: określony zasób (projekt, MapConfig lub StyleConfig) nie istnieje.
  • INVALID_ARGUMENT: treść żądania jest nieprawidłowa lub zawiera nieprawidłowe wartości pól.