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

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

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

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

• ऑथराइज़ेशन हेडर: 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/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
  }
}'

अनुरोध पूरा होने पर, आपको नया Map Config ऑब्जेक्ट मिलेगा:

{
  "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 प्रोजेक्ट का नंबर या आईडी पाने के लिए:

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

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