พารามิเตอร์คําขอที่จําเป็น

หากต้องการส่งคำขอไปยัง Map Management API คุณต้องใส่ข้อมูลต่อไปนี้ในส่วนหัวและ URL

• ตัวระบุโปรเจ็กต์: หมายเลขหรือรหัสโปรเจ็กต์ Google Cloud ในส่วนหัว X-Goog-User-Project ค่านี้จะเป็นตัวกำหนดโปรเจ็กต์ที่ใช้สำหรับการเรียกเก็บเงินและการคำนวณโควต้า

  หมายเหตุ: หากคุณใช้บัญชีบริการสำหรับการตรวจสอบสิทธิ์ คุณสามารถละเว้น ส่วนหัว X-Goog-User-Project ได้

• ส่วนหัวการให้สิทธิ์: โทเค็น OAuth 2.0 ในส่วนหัว Authorization ดูข้อมูลเพิ่มเติมได้ที่หัวข้อการใช้ OAuth

• ชื่อทรัพยากร: หมายเลขหรือรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ใน URL ของคำขอ พร้อมด้วยรหัสทรัพยากรที่เฉพาะเจาะจง (เช่น mapConfigId หรือ styleConfigId)

หมายเหตุ: คำขอบางรายการต้องใช้พารามิเตอร์เพิ่มเติม ซึ่งมีรายละเอียดอยู่ในข้อมูลอ้างอิง API

ตัวอย่าง: สร้าง 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
  }
}'

หากคำขอสำเร็จ คุณจะได้รับออบเจ็กต์การกำหนดค่าแผนที่ที่สร้างขึ้นใหม่ ดังนี้

{
  "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 Console
2. หมายเลขโปรเจ็กต์ และรหัสโปรเจ็กต์ จะปรากฏในส่วนข้อมูลโปรเจ็กต์

รับโทเค็น OAuth

สำหรับการพัฒนาหรือการทดสอบ คุณสามารถใช้ gcloud CLI เพื่อสร้างโทเค็น 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