필수 요청 매개변수

Map Management API에 요청을 하려면 헤더와 URL에 다음을 포함해야 합니다.

  • 프로젝트 식별자: X-Goog-User-Project 헤더에 있는 Google Cloud 프로젝트의 프로젝트 번호 또는 ID입니다. 이 값은 청구 및 할당량 계산에 사용되는 프로젝트를 결정합니다.

  • 승인 헤더: Authorization 헤더의 OAuth 2.0 토큰입니다. 자세한 내용은 OAuth 사용을 참고하세요.

  • 리소스 이름: 요청 URL의 Google Cloud 프로젝트 번호 또는 ID와 특정 리소스 ID (예: mapConfigId 또는 styleConfigId)입니다.

예시: MapConfig 만들기

다음 예에서는 curl을 사용하여 MapConfig 객체를 만드는 방법을 보여줍니다. 이 요청을 보내면 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
  }
}'

요청이 성공하면 새로 생성된 지도 구성 객체가 수신됩니다. 

{
  "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 삭제

다음 예에서는 curl을 사용하여 MapConfig 객체를 삭제하는 방법을 보여줍니다. 이 요청을 보내면 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/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

요청이 성공하면 빈 응답 객체가 수신됩니다. 

{}

프로젝트 번호 가져오기

Google Cloud 프로젝트의 번호 또는 ID를 가져오려면 다음 단계를 따르세요.

  1. Cloud 콘솔에서 프로젝트의 개요 페이지로 이동합니다.
  2. 프로젝트 번호 와 프로젝트 ID 가 프로젝트 정보 영역에 표시됩니다.

OAuth 토큰 가져오기

개발 또는 테스트를 위해 gcloud CLI를 사용하여 임시 OAuth 토큰을 생성할 수 있습니다.

gcloud auth application-default print-access-token

앞의 예와 같이 curl 요청의 Authorization 헤더에 gcloud 명령어를 직접 포함할 수 있습니다. 또는 환경 변수를 설정합니다.

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