Wymagane parametry żądania

Aby wysłać żądanie do interfejsu Map Management API, musisz uwzględnić w nagłówkach i adresach URL te informacje:

  • Identyfikator projektu: numer lub identyfikator projektu Google Cloud w nagłówku X-Goog-User-Project. Ta wartość określa projekt używany do rozliczeń i obliczania limitów.

  • Nagłówek autoryzacji: token OAuth 2.0 w nagłówku Authorization. Więcej informacji znajdziesz w artykule Korzystanie z OAuth.

  • Nazwa zasobu: numer lub identyfikator projektu Google Cloud w adresie URL żądania wraz z identyfikatorem konkretnego zasobu (np. mapConfigId lub styleConfigId).

Przykład: tworzenie obiektu MapConfig

Poniższy przykład pokazuje, jak utworzyć obiekt MapConfig za pomocą narzędzia curl. Jeśli tworzenie obiektu MapConfig zakończy się pomyślnie, po wysłaniu tej prośby otrzymasz w odpowiedzi nowo utworzony obiekt.

curl -X POST \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs -d '{
  "displayName": "My New York Map",
  "description": "A Map for New York City",
  "mapType" : "VECTOR",
  "mapFeatures": {
    "simpleFeatures": ["FLATTEN_BUILDINGS", "ICONIC_ICONS"],
    "poiBoostLevel": 1
  }
}'

Jeśli żądanie zostanie wykonane, otrzymasz nowo utworzony obiekt konfiguracji mapy: 

{
  "name": "projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID",
  "displayName": "Testing No Type",
  "description": "Testing",
  "mapId": "YOUR_MAP_CONFIG_ID",
  "mapFeatures": {
    "simpleFeatures": [
      "FLATTEN_BUILDINGS",
      "ICONIC_ICONS"
    ],
    "poiBoostLevel": 1
  },
  "createTime": "2026-02-07T20:04:11.467243390Z",
  "updateTime": "2026-02-07T20:04:11.467243542Z",
  "mapType": "VECTOR"
}

Przykład: usuwanie elementu MapConfig

Poniższy przykład pokazuje, jak usunąć obiekt MapConfig za pomocą curl. Gdy wyślesz tę prośbę, otrzymasz pusty obiekt JSON {} w odpowiedzi, jeśli konfiguracja MapConfig została znaleziona i usunięta.

curl -X DELETE \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

Jeśli żądanie zostanie zrealizowane, otrzymasz pusty obiekt odpowiedzi: 

{}

Uzyskiwanie numeru projektu

Aby uzyskać numer lub identyfikator projektu Google Cloud:

  1. W konsoli Cloud otwórz stronę Przegląd projektu.
  2. Numer projektu i Identyfikator projektu są wyświetlane w obszarze Informacje o projekcie.

Uzyskiwanie tokena OAuth

Do celów programistycznych lub testowych możesz użyć interfejsu wiersza poleceń gcloud, aby wygenerować tymczasowy token OAuth:

gcloud auth application-default print-access-token

Możesz umieścić polecenie gcloud bezpośrednio w nagłówku Authorization żądania curl, jak pokazano w przykładach powyżej. Możesz też ustawić zmienną środowiskową:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X GET \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $TOKEN" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs