Parâmetros de solicitação obrigatórios

Para fazer qualquer solicitação à API Map Management, inclua o seguinte nos cabeçalhos e URLs:

  • Identificador do projeto: o número ou ID do seu projeto na nuvem do Google Cloud no cabeçalho X-Goog-User-Project. Esse valor determina o projeto usado para cálculos de faturamento e cota.

  • Cabeçalho de autorização: um token OAuth 2.0 no cabeçalho Authorization. Para mais informações, consulte Usar o OAuth.

  • Nome do recurso: um número ou ID de projeto na nuvem do Google Cloud no URL da solicitação, junto com o ID do recurso específico (como mapConfigId ou styleConfigId).

Exemplo: criar um MapConfig

O exemplo a seguir mostra como criar um objeto MapConfig usando curl. Ao enviar essa solicitação, você recebe o objeto recém-criado em resposta se a criação do MapConfig for concluída com sucesso.

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

Se a solicitação for bem-sucedida, você vai receber o objeto de configuração de mapa recém-criado: 

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

Exemplo: excluir um MapConfig

O exemplo a seguir mostra como excluir um objeto MapConfig usando curl. Ao enviar essa solicitação, você vai receber um objeto JSON vazio {} em resposta se o MapConfig for encontrado e excluído com sucesso.

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

Se a solicitação for bem-sucedida, você vai receber um objeto de resposta vazio: 

{}

Consiga o número do projeto

Para conseguir o número ou ID do seu projeto do Google Cloud:

  1. Acesse a página de visão geral do projeto no console do Cloud.
  2. O Número do projeto e o ID do projeto aparecem na área Informações do projeto.

Receber um token OAuth

Para desenvolvimento ou teste, use a CLI gcloud para gerar um token OAuth temporário:

gcloud auth application-default print-access-token

É possível incluir o comando gcloud diretamente no cabeçalho Authorization de uma solicitação curl, conforme mostrado nos exemplos anteriores. Como alternativa, defina uma variável de ambiente:

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