প্রয়োজনীয় অনুরোধের পরামিতি

ম্যাপ ম্যানেজমেন্ট এপিআই-তে যেকোনো অনুরোধ করার জন্য, আপনাকে আপনার হেডার এবং ইউআরএল-এ নিম্নলিখিত বিষয়গুলো অবশ্যই অন্তর্ভুক্ত করতে হবে:

  • প্রজেক্ট আইডেন্টিফায়ার : X-Goog-User-Project হেডারে থাকা আপনার গুগল ক্লাউড প্রজেক্টের প্রজেক্ট নম্বর বা আইডি। এই মানটি বিলিং এবং কোটা গণনার জন্য ব্যবহৃত প্রজেক্ট নির্ধারণ করে।

  • অথরাইজেশন হেডার : Authorization হেডারে একটি OAuth 2.0 টোকেন। আরও তথ্যের জন্য, Use OAuth দেখুন।

  • রিসোর্সের নাম : অনুরোধ URL-এ একটি 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

অনুরোধটি সফল হলে, আপনি একটি খালি প্রতিক্রিয়া অবজেক্ট পাবেন:

{}

প্রকল্প নম্বরটি নিন

আপনার গুগল ক্লাউড প্রজেক্টের নম্বর বা আইডি পেতে:

  1. ক্লাউড কনসোলে প্রজেক্টটির ওভারভিউ পেজে যান।
  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