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

Để gửi bất kỳ yêu cầu nào đế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:

  • Giá trị nhận dạng dự án: Số hoặc mã dự án trên đám mây Google 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 MapConfig được tạo 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/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
  }
}'

Nếu yêu cầu thành công, bạn sẽ nhận được đối tượng Cấu hình bản đồ 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á MapConfig

Ví dụ sau đây cho thấy 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/v2/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 Cloud Console.
  2. Số dự án và Mã dự án xuất hiện trong phần Thông tin dự án.

Lấy 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 một 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs