ম্যাপ ম্যানেজমেন্ট এপিআই গাইড এবং উদাহরণ, ম্যাপ ম্যানেজমেন্ট এপিআই গাইড এবং উদাহরণ

আপনি ম্যাপ ম্যানেজমেন্ট এপিআই ব্যবহার করে v2alpha (পরীক্ষামূলক) এবং v2beta (প্রিভিউ) উভয় এন্ডপয়েন্ট জুড়েই আপনার ক্লাউড-ভিত্তিক ম্যাপের স্টাইলিং রিসোর্সসমূহ প্রোগ্রাম্যাটিকভাবে পরিচালনা করতে পারেন।

কার্যক্রমের সারসংক্ষেপ

ম্যাপ ম্যানেজমেন্ট এপিআই ব্যবহার করে একটি কাস্টম ম্যাপ দেখতে, এই মূল ধাপগুলো অনুসরণ করুন:

1. একটি স্টাইলকনফিগ তৈরি করুন : রঙ, দৃশ্যমানতা এবং ঘনত্বের সেটিংসের JSON উপস্থাপনা ব্যবহার করে আপনার ম্যাপের দৃশ্যমান রূপ নির্ধারণ করুন।
2. একটি MapConfig তৈরি করুন : একটি অনন্য Map ID নির্ধারণ করুন যা আপনার ম্যাপের পরিচয় এবং উচ্চ-স্তরের বৈশিষ্ট্যগুলির ধারক হিসাবে কাজ করে।
3. এগুলোকে একটি MapContextConfig-এর সাথে যুক্ত করুন : আপনার MapConfig মধ্যে আপনার StyleConfig (এবং ঐচ্ছিক ডেটাসেট)-কে নির্দিষ্ট মানচিত্রের প্রকারভেদের (যেমন ROADMAP বা SATELLITE ) সাথে লিঙ্ক করুন।

ডিফল্ট আচরণ

v2 এন্ডপয়েন্টগুলো ব্যবহার করার সময়, নিম্নলিখিত ডিফল্ট আচরণগুলো মনে রাখবেন:

• ম্যাপের ধরণ : ডিফল্ট ম্যাপ রেন্ডারিং ধরণ হলো RASTER । ভেক্টর-ভিত্তিক ম্যাপ ব্যবহার করতে হলে, আপনাকে অবশ্যই আপনার MapConfig এ map_type VECTOR হিসেবে স্পষ্টভাবে সেট করতে হবে।
• ম্যাপ ভ্যারিয়েন্ট : MapContextConfig তৈরি করার সময় যদি কোনো map_variants নির্দিষ্ট করা না থাকে, তাহলে কনফিগারেশনটি ডিফল্টরূপে শুধুমাত্র ROADMAP ভ্যারিয়েন্টের জন্য প্রযোজ্য হবে।
• বেস স্টাইলিং : যদি json_style_sheet খালি থাকে অথবা StyleConfig এ তা প্রদান করা না হয়, তাহলে ডিফল্ট স্টাইলবিহীন গুগল বেস ম্যাপ ব্যবহার করা হবে।

স্টাইলকনফিগ নিয়ে কাজ করা

StyleConfig এ JSON-ভিত্তিক স্টাইলিং সংজ্ঞাগুলো থাকে।

একটি স্টাইলকনফিগ তৈরি করুন

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

তালিকা স্টাইলকনফিগস

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

MapConfigs নিয়ে কাজ করা

MapConfig একটি মানচিত্রের পরিচয় এবং মূল রেন্ডারিং ধরণ নির্ধারণ করে।

একটি MapConfig তৈরি করুন

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

MapContextConfigs নিয়ে কাজ করা

একটি MapContextConfig অন্য একটি MapConfig এর সাথে স্টাইলিং সংযুক্ত করে।

একটি MapContextConfig তৈরি করুন

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

ত্রুটি

• অনুমতি প্রত্যাখ্যাত : অনুরোধটির পর্যাপ্ত IAM অনুমতি নেই অথবা প্রজেক্টটিতে API সক্রিয় করা নেই।
• NOT_FOUND : নির্দিষ্ট রিসোর্সটি (Project, MapConfig, বা StyleConfig) বিদ্যমান নেই।
• INVALID_ARGUMENT : অনুরোধের মূল অংশটি ত্রুটিপূর্ণ অথবা এতে অবৈধ ফিল্ড মান রয়েছে।