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

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

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

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

• Authorization Header: 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
  }
}'

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

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

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/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs