Обязательные параметры запроса

Чтобы отправить запрос к Map Management API, необходимо добавить в заголовки и URL следующие данные:

  • Идентификатор проекта. Номер или идентификатор проекта Google Cloud в заголовке X-Goog-User-Project. Это значение определяет проект, который используется для расчета квот и оплаты.

  • Заголовок Authorization – токен OAuth 2.0 в заголовке Authorization. Подробнее об использовании OAuth…

  • Имя ресурса. Номер или идентификатор облачного проекта Google Cloud в URL запроса, а также идентификатор определенного ресурса (например, mapConfigId или styleConfigId).

Пример: создание MapConfig

В следующем примере показано, как создать объект MapConfig с помощью curl. Если объект MapConfig создан успешно, в ответ на запрос вы получите новый объект.

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/v2/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
  }
}'

Если запрос выполнен успешно, вы получите созданный объект Map Config: 

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

Пример: удаление MapConfig

В следующем примере показано, как удалить объект MapConfig с помощью curl. Если объект MapConfig найден и успешно удален, в ответ на этот запрос вы получите пустой объект 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

Если запрос выполнен успешно, вы получите пустой объект ответа: 

{}

Как узнать номер проекта

Чтобы узнать номер или идентификатор проекта Google Cloud, выполните следующие действия:

  1. Перейдите на обзорную страницу проекта в консоли Cloud.
  2. Номер проекта и идентификатор проекта указаны в разделе Информация о проекте.

Как получить токен OAuth

Для разработки или тестирования можно использовать интерфейс командной строки gcloud, чтобы создать временный токен OAuth:

gcloud auth application-default print-access-token

Вы можете включить команду gcloud непосредственно в заголовок Authorization запроса curl, как показано в примерах выше. Вы также можете задать переменную среды:

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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs