Wymagane parametry żądania

Aby wysłać jakiekolwiek żądanie do interfejsu API zarządzania mapami, musisz uwzględnić w nagłówkach i adresach URL te elementy:

  • 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 w chmurze Google w adresie URL żądania wraz z konkretnym identyfikatorem zasobu (np. mapConfigId lub styleConfigId).

Przykład: tworzenie MapConfig

Ten przykład pokazuje, jak utworzyć obiekt MapConfig za pomocą narzędzia curl. Jeśli utworzenie MapConfig się powiedzie, po wysłaniu tego żądania 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 się powiedzie, 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 MapConfig

Ten przykład pokazuje, jak usunąć obiekt MapConfig za pomocą narzędzia curl. Jeśli MapConfig zostanie znaleziony i usunięty, po wysłaniu tego żądania otrzymasz w odpowiedzi pusty obiekt JSON {}.

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 się powiedzie, otrzymasz pusty obiekt odpowiedzi: 

{}

Pobieranie 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 pojawią się w sekcji Informacje o projekcie.

Uzyskiwanie tokena OAuth

Na potrzeby programowania lub testowania możesz użyć interfejsu wiersza poleceń gcloud, aby wygenerować tymczasowy token OAuth:

gcloud auth application-default print-access-token

Polecenie gcloud możesz umieścić bezpośrednio w nagłówku Authorization żądania curl, jak pokazano w poprzednich przykładach. 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