মানচিত্র টাইলস API এর সাথে সেশন টোকেন ব্যবহার করুন

সেশন টোকেন হলো এক প্রকার ডেটা (একটি UUID ) যা REST কলে একটি সেশন —অর্থাৎ সম্পর্কিত বার্তা আদান-প্রদানের একটি ধারাবাহিকতা—শনাক্ত করতে ব্যবহৃত হয়। 2D টাইলস এবং স্ট্রিট ভিউ ইমেজারির জন্য করা সমস্ত অনুরোধে আপনাকে অবশ্যই একটি সেশন টোকেন অন্তর্ভুক্ত করতে হবে। সমস্ত অনুরোধ URL-এর শেষে একটি session প্যারামিটারের ভ্যালু হিসেবে এটি যুক্ত করতে হয়।

ম্যাপ টাইলস এপিআই-তে, একটি সেশন টোকেন নির্দিষ্ট কিছু ডিসপ্লে অপশনকে বোঝায়। এর মানে হলো, প্রতিটি টাইল রিকোয়েস্টের সাথে আপনাকে ডিসপ্লে অপশনের একটি সেট পাস করতে হবে না। আপনি একাধিক ক্লায়েন্টে একই সেশন টোকেন ব্যবহার করতে পারেন। একটি সেশন টোকেন বর্তমানে ইস্যু হওয়ার সময় থেকে দুই সপ্তাহের জন্য বৈধ থাকে, কিন্তু এটি পরিবর্তিত হতে পারে। আপনি রেসপন্স মেসেজের ' expiry ' ফিল্ডটি দেখে সেশন টোকেনের মেয়াদ শেষ হওয়ার সময় সর্বদা যাচাই করতে পারেন।

সেশন টোকেন অনুরোধ

সেশন টোকেন অনুরোধ করতে, নিচের উদাহরণে দেখানো অনুযায়ী createSession এন্ডপয়েন্টে একটি HTTPS POST অনুরোধ পাঠান। আপনাকে অবশ্যই Content-Type: application/json হেডার সহ অনুরোধটি পাঠাতে হবে।

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

প্রয়োজনীয় ক্ষেত্রসমূহ

mapType

বেস ম্যাপের ধরণ। এই মানটি নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

roadmap

গুগল ম্যাপসের সাধারণ রঙিন মানচিত্র টাইলস।

satellite

স্যাটেলাইট চিত্র।

terrain

ভূখণ্ডের চিত্রাবলী। মানচিত্রের ধরণ হিসেবে terrain নির্বাচন করার সময়, আপনাকে অবশ্যই layerRoadmap লেয়ারের ধরণটিও অন্তর্ভুক্ত করতে হবে (যা ঐচ্ছিক ক্ষেত্রসমূহ বিভাগে বর্ণিত আছে)।

streetview

স্ট্রিট ভিউ প্যানোরামা। আরও তথ্যের জন্য, স্ট্রিট ভিউ টাইলস দেখুন।

language

একটি IETF ল্যাঙ্গুয়েজ ট্যাগ যা টাইলগুলিতে তথ্য প্রদর্শনের জন্য ব্যবহৃত ভাষা নির্দিষ্ট করে। উদাহরণস্বরূপ, en-US মার্কিন যুক্তরাষ্ট্রে প্রচলিত ইংরেজি ভাষাকে নির্দিষ্ট করে।

region

কমন লোকাল ডেটা রিপোজিটরি অঞ্চলের একটি শনাক্তকারী (দুটি বড় হাতের অক্ষর) যা ব্যবহারকারীর ভৌতিক অবস্থানকে নির্দেশ করে। উদাহরণস্বরূপ, US ।

ঐচ্ছিক ক্ষেত্র

imageFormat

ফেরত দেওয়ার জন্য ফাইল ফরম্যাট নির্দিষ্ট করে। বৈধ মান হলো jpeg অথবা png । JPEG ফাইলে স্বচ্ছতা থাকে না, তাই ওভারলে টাইলের জন্য এগুলো ব্যবহার করার পরামর্শ দেওয়া হয় না। আপনি যদি কোনো imageFormat নির্দিষ্ট না করেন, তাহলে টাইলের জন্য সেরা ফরম্যাটটি স্বয়ংক্রিয়ভাবে বেছে নেওয়া হয়।

scale

ডিফল্ট টাইলের আকার এবং আওতাধীন এলাকা অপরিবর্তিত রেখে ম্যাপের উপাদানগুলোর (যেমন রাস্তার লেবেল) আকার বড় করে। স্কেল বাড়ালে ম্যাপে লেবেলের সংখ্যাও কমে যায়, যা ম্যাপকে জঞ্জালমুক্ত রাখে। নিম্নলিখিত মানগুলো বৈধ scale মান:

• scaleFactor1x : ডিফল্ট।
• scaleFactor2x : লেবেলের আকার দ্বিগুণ করে এবং গৌণ ফিচার লেবেলগুলো সরিয়ে দেয়।
• scaleFactor4x : লেবেলের আকার চারগুণ করে এবং গৌণ ফিচার লেবেলগুলো সরিয়ে দেয়।

নিম্নলিখিত উদাহরণগুলো মানচিত্রের উপাদানগুলোর স্কেলিং-এর প্রভাব প্রদর্শন করে।

স্কেল ফ্যাক্টর 1x	স্কেল ফ্যাক্টর 2x

highDpi

উচ্চ-রেজোলিউশনের টাইলস ফেরত দেওয়া হবে কিনা তা নির্দিষ্ট করে। যদি স্কেল-ফ্যাক্টর বাড়ানো হয়, তাহলে টাইলের আকার বাড়ানোর জন্য highDpi ব্যবহার করা হয়। সাধারণত, স্কেল ফ্যাক্টর বাড়ালে ফলাফলস্বরূপ টাইলটি একই আকারের একটি ছবিতে পরিণত হয়, যা ছবির গুণমান কমিয়ে দেয়। highDpi ব্যবহার করলে, ছবির আকারও বৃদ্ধি পায় এবং গুণমান বজায় থাকে। ডিপিআই (DPI)-এর পূর্ণরূপ হলো ডটস পার ইঞ্চি (Dots per Inch), এবং হাই ডিপিআই (High DPI) মানে হলো টাইলটি স্বাভাবিকের চেয়ে বেশি ডটস পার ইঞ্চি ব্যবহার করে রেন্ডার হবে। যদি true , তাহলে x এবং y প্রতিটি দিকের পিক্সেল সংখ্যাকে স্কেল ফ্যাক্টর (অর্থাৎ, 2x বা 4x) দিয়ে গুণ করা হয়। টাইলের কভারেজ এলাকা অপরিবর্তিত থাকে। এই প্যারামিটারটি শুধুমাত্র 2x বা 4x scale মানের সাথে কাজ করে। 1x স্কেলের টাইলের উপর এর কোনো প্রভাব নেই।

স্কেল ফ্যাক্টর 1x	স্কেল ফ্যাক্টর ২x উচ্চ ডিপিআই

layerTypes

মানগুলির একটি অ্যারে যা মানচিত্রে যুক্ত করা লেয়ারের প্রকারগুলি নির্দিষ্ট করে। বৈধ মানগুলি হলো:

layerRoadmap

মানচিত্রের ধরণ হিসেবে terrain নির্দিষ্ট করলে এটি আবশ্যক। এটি ঐচ্ছিকভাবে satellite মানচিত্রের উপরও স্থাপন করা যেতে পারে। সড়ক মানচিত্রের টাইলগুলির উপর এর কোনো প্রভাব নেই।

layerStreetview

মানচিত্রে নীল রূপরেখা ব্যবহার করে স্ট্রিট ভিউ-সক্ষম রাস্তা ও স্থানগুলো দেখানো হয়।

layerTraffic

বর্তমান ট্র্যাফিকের অবস্থা প্রদর্শন করে।

styles

JSON স্টাইলের অবজেক্টের একটি অ্যারে, যা রাস্তা, পার্ক এবং জনবসতিপূর্ণ এলাকার মতো ম্যাপের বৈশিষ্ট্যগুলির চেহারা এবং বিস্তারিত বিবরণের স্তর নির্দিষ্ট করে। স্ট্যান্ডার্ড গুগল বেস ম্যাপকে কাস্টমাইজ করতে স্টাইলিং ব্যবহার করা হয়। styles প্যারামিটারটি শুধুমাত্র তখনই বৈধ হবে যখন ম্যাপের ধরন হবে roadmap । সম্পূর্ণ স্টাইল সিনট্যাক্সের জন্য, `Style Reference` দেখুন।

overlay

একটি বুলিয়ান মান যা নির্দিষ্ট করে যে layerTypes একটি পৃথক ওভারলে হিসাবে রেন্ডার করা হবে, নাকি মূল চিত্রের সাথে একত্রিত করা হবে। যখন এর মান true , তখন মূল মানচিত্রটি প্রদর্শিত হয় না। যদি আপনি কোনো layerTypes সংজ্ঞায়িত না করে থাকেন, তাহলে এই মানটি উপেক্ষা করা হয়।

উদাহরণস্বরূপ, ` layerRoadmap লেয়ার সহ একটি satellite ম্যাপ টাইপ অনুরোধ করলে এবং overlay ` false সেট করা থাকলে, `Maps JavaScript API`-তে ব্যবহৃত hybrid ম্যাপ টাইপের সমতুল্য টাইলস পাওয়া যায় (বাম দিকের ছবি)। একই ম্যাপ এবং লেয়ার টাইপের ক্ষেত্রে overlay ` true সেট করা হলে, স্যাটেলাইট চিত্রের উপর ওভারলে করার জন্য উপযুক্তভাবে স্টাইল করা একটি ম্যাপ ওভারলে সহ স্বচ্ছ টাইল পাওয়া যায় (ডান দিকের ছবি)।

overlay : মিথ্যা	overlay : সত্য

নিম্নলিখিত JSON-টি একটি সাধারণ রিকোয়েস্ট বডির উদাহরণ, যাতে আবশ্যক এবং ঐচ্ছিক উভয় ধরনের ফিল্ড রয়েছে।

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

এই উদাহরণটি স্যাটেলাইট চিত্রের সাথে একত্রিত করার উপযোগী একটি ওভারলে প্রদান করে। উদাহরণটিতে একটি রোডম্যাপ এবং একটি স্ট্রিট ভিউ ওভারলে উভয়ই রয়েছে। ফলস্বরূপ মানচিত্রটি মার্কিন যুক্তরাষ্ট্রে প্রচলিত ইংরেজি ভাষায় নাম এবং তথ্য সহ রেন্ডার করা হয়।

সেশন টোকেন প্রতিক্রিয়া

নিম্নলিখিত JSON-টি একটি উদাহরণ প্রতিক্রিয়া বডি।

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

নিম্নলিখিত তালিকায় রেসপন্স বডিতে থাকা ফিল্ডগুলোর সংজ্ঞা দেওয়া আছে।

session

একটি সেশন টোকেন ভ্যালু যা আপনাকে আপনার সমস্ত ম্যাপ টাইলস এপিআই অনুরোধে অবশ্যই অন্তর্ভুক্ত করতে হবে।

expiry

একটি স্ট্রিং, যাতে টোকেনটির মেয়াদ শেষ হওয়ার সময় (ইপক থেকে সেকেন্ডে) উল্লেখ থাকে। একটি সেশন টোকেন তৈরির সময় থেকে দুই সপ্তাহের জন্য বৈধ থাকে, কিন্তু এই নীতি কোনো বিজ্ঞপ্তি ছাড়াই পরিবর্তিত হতে পারে।

tileWidth

টাইলগুলির প্রস্থ পিক্সেলে পরিমাপ করা হয়।

tileHeight

টাইলগুলির উচ্চতা পিক্সেলে পরিমাপ করা হয়।

imageFormat

ইমেজ ফরম্যাট, যা png অথবা jpeg হতে পারে।