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

Для отправки запроса к API управления картами необходимо включить в заголовки и URL-адреса следующее:

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

  • Заголовок авторизации : Токен 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/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
  }
}'

Если запрос будет выполнен успешно, вы получите вновь созданный объект 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. При отправке этого запроса вы получите в ответ пустой JSON-объект {} если объект MapConfig был найден и успешно удален.

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

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

{}

Получите номер проекта

Чтобы получить номер или идентификатор вашего проекта в Google Cloud:

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

Получите токен OAuth

Для разработки или тестирования вы можете использовать CLI 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/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs