মানচিত্র টাইলস 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 : লেবেলের আকার চারগুণ করে এবং ছোটখাটো বৈশিষ্ট্যের লেবেলগুলি সরিয়ে দেয়।

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

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

highDpi

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

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

layerTypes

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

layerRoadmap

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

layerStreetview

মানচিত্রে নীল রূপরেখা ব্যবহার করে রাস্তার দৃশ্য-সক্ষম রাস্তা এবং অবস্থানগুলি দেখায়।

layerTraffic

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

styles

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

overlay

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

উদাহরণস্বরূপ, একটি layerRoadmap স্তর সহ একটি satellite মানচিত্রের ধরণ অনুরোধ করা, এবং Maps JavaScript API (বাম চিত্র) তে ব্যবহৃত hybrid মানচিত্রের ধরণ সমতুল্য টাইলসগুলিতে overlay false ফলাফলে সেট করা। একই মানচিত্র এবং স্তরের ধরণ সহ 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

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

expiry

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

tileWidth

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

tileHeight

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

imageFormat

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