ज़रूरी अनुरोध पैरामीटर

Map Management API से कोई भी अनुरोध करने के लिए, आपको अपने हेडर और यूआरएल में यह जानकारी शामिल करनी होगी:

• प्रोजेक्ट आइडेंटिफ़ायर: X-Goog-User-Project हेडर में मौजूद, आपके Google Cloud प्रोजेक्ट का प्रोजेक्ट नंबर या आईडी. इस वैल्यू से यह तय होता है कि बिलिंग और कोटा के हिसाब-किताब के लिए किस प्रोजेक्ट का इस्तेमाल किया जाएगा.

  ध्यान दें: अगर पुष्टि करने के लिए किसी सेवा खाते का इस्तेमाल किया जा रहा है, तो X-Goog-User-Project हेडर को हटाया जा सकता है.

• Authorization हेडर: Authorization हेडर में मौजूद OAuth 2.0 टोकन. ज़्यादा जानकारी के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.

• संसाधन का नाम: अनुरोध के यूआरएल में मौजूद Google Cloud प्रोजेक्ट नंबर या आईडी. साथ ही, संसाधन का आईडी, जैसे कि 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/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
  }
}'

अगर अनुरोध पूरा हो जाता है, तो आपको नया मैप कॉन्फ़िगरेशन ऑब्जेक्ट मिलेगा:

{
  "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 ऑब्जेक्ट को मिटाने का तरीका बताया गया है. यह अनुरोध भेजने पर, आपको जवाब के तौर पर खाली 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/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

अनुरोध पूरा होने पर, आपको एक खाली जवाब ऑब्जेक्ट मिलता है:

{}

प्रोजेक्ट नंबर पाना

अपने Google Cloud प्रोजेक्ट का नंबर या आईडी पाने के लिए:

1. Cloud Console में, प्रोजेक्ट के खास जानकारी वाले पेज पर जाएं.
2. प्रोजेक्ट नंबर और प्रोजेक्ट आईडी, प्रोजेक्ट की जानकारी वाले सेक्शन में दिखते हैं.

OAuth टोकन पाना

डेवलपमेंट या टेस्टिंग के लिए, gcloud सीएलआई का इस्तेमाल करके कुछ समय के लिए OAuth टोकन जनरेट किया जा सकता है:

gcloud auth application-default print-access-token

gcloud कमांड को सीधे curl अनुरोध के Authorization हेडर में शामिल किया जा सकता है. इसके बारे में पहले दिए गए उदाहरणों में बताया गया है. इसके अलावा, कोई एनवायरमेंट वैरिएबल सेट करें:

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