Przewodnik i przykłady interfejsu Map Management API

Interfejs Map Management API umożliwia programowe zarządzanie zasobami definiowania stylów map w Google Cloud w przypadku punktów końcowych v2alpha (eksperymentalnych) i v2beta (wersja zapoznawcza).

Podsumowanie operacji

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

  1. Utwórz element 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 obiektem MapContextConfig: połącz swoje StyleConfig (i opcjonalne zbiory danych) z konkretnymi wariantami mapy (np. ROADMAP lub SATELLITE) w ramach MapConfig.

Domyślne zachowania

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

  • Typ mapy: domyślny typ renderowania mapy to RASTER. Aby korzystać z map wektorowych, musisz w MapConfig wyraźnie ustawić wartość map_type na VECTOR.
  • Map Variant: jeśli podczas tworzenia MapContextConfig nie określono żadnych map_variants, konfiguracja będzie domyślnie stosowana tylko do wariantu ROADMAP.
  • Styl podstawowy: jeśli element json_style_sheet jest pusty lub nie został podany w elemencie StyleConfig, używana będzie domyślna, nieostylowana mapa podstawowa Google.

Praca z komponentami StyleConfigs

Plik StyleConfig zawiera definicje stylów oparte na formacie JSON.

Tworzenie konfiguracji stylu

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 konfiguracji stylu

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

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

Tworzenie konfiguracji mapy

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 obiektami MapContextConfig

Element MapContextConfig łączy styl z elementem MapConfig.

Tworzenie konfiguracji 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łowo sformatowana lub zawiera nieprawidłowe wartości pól.