Thông số yêu cầu bắt buộc

Để gửi yêu cầu đến API Quản lý bản đồ, bạn phải thêm những thông tin sau vào tiêu đề và URL:

  • Mã nhận dạng dự án: Số hoặc mã dự án trên đám mây của Google Cloud của bạn trong tiêu đề X-Goog-User-Project. Giá trị này xác định dự án được dùng để tính toán hạn mức và thanh toán.

  • Tiêu đề uỷ quyền: Mã thông báo OAuth 2.0 trong tiêu đề Authorization. Để biết thêm thông tin, hãy xem bài viết Sử dụng OAuth.

  • Tên tài nguyên: Số hoặc mã dự án trên đám mây của Google trong URL yêu cầu, cùng với mã tài nguyên cụ thể (chẳng hạn như mapConfigId hoặc styleConfigId).

Ví dụ: Tạo MapConfig

Ví dụ sau đây cho thấy cách tạo đối tượng MapConfig bằng curl. Khi gửi yêu cầu này, bạn sẽ nhận được đối tượng mới tạo trong phản hồi nếu quá trình tạo MapConfig hoàn tất thành công.

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

Nếu yêu cầu thành công, bạn sẽ nhận được đối tượng Map Config mới tạo: 

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

Ví dụ: Xoá một MapConfig

Ví dụ sau đây minh hoạ cách xoá một đối tượng MapConfig bằng curl. Khi gửi yêu cầu này, bạn sẽ nhận được một đối tượng JSON trống {} trong phản hồi nếu MapConfig được tìm thấy và xoá thành công.

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

Nếu yêu cầu thành công, bạn sẽ nhận được một đối tượng phản hồi trống: 

{}

Lấy số dự án

Cách lấy số hoặc mã dự án trên Google Cloud:

  1. Chuyển đến trang Tổng quan của dự án trong bảng điều khiển Cloud.
  2. Số dự án và Mã dự án xuất hiện trong phần Thông tin dự án.

Nhận mã thông báo OAuth

Để phát triển hoặc kiểm thử, bạn có thể sử dụng CLI gcloud để tạo mã thông báo OAuth tạm thời:

gcloud auth application-default print-access-token

Bạn có thể đưa lệnh gcloud trực tiếp vào tiêu đề Authorization của yêu cầu curl như trong các ví dụ trước đó. Ngoài ra, hãy đặt một biến môi trường:

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