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

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

মানচিত্র টাইলস API-এ, একটি সেশন টোকেন প্রদর্শন বিকল্পগুলির একটি সংজ্ঞায়িত সেট উপস্থাপন করে। এর অর্থ হল প্রতিটি টাইল অনুরোধের সাথে আপনাকে প্রদর্শন বিকল্পগুলির একটি সেট পাস করতে হবে না। আপনি একাধিক ক্লায়েন্ট জুড়ে একই সেশন টোকেন ব্যবহার করতে পারেন। একটি সেশন টোকেন বর্তমানে ইস্যু করার সময় থেকে দুই সপ্তাহের জন্য বৈধ, তবে এটি পরিবর্তন হতে পারে। প্রতিক্রিয়া বার্তায় expiry ক্ষেত্রটি দেখে আপনি সর্বদা একটি সেশন টোকেনের মেয়াদ শেষ হওয়ার সময় পরীক্ষা করতে পারেন।

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

একটি সেশন টোকেন অনুরোধ করতে, একটি HTTPS POST অনুরোধ createSession এন্ডপয়েন্টে পাঠান, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনাকে অবশ্যই একটি 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
স্ট্যান্ডার্ড Google Maps আঁকা মানচিত্র টাইলস.
satellite
স্যাটেলাইট ছবি।
terrain
ভূখণ্ডের চিত্র। মানচিত্রের ধরন হিসাবে terrain নির্বাচন করার সময়, আপনাকে অবশ্যই layerRoadmap স্তরের প্রকার অন্তর্ভুক্ত করতে হবে ( ঐচ্ছিক ক্ষেত্র বিভাগে বর্ণিত)।
streetview
রাস্তার দৃশ্য প্যানোরামা। আরও তথ্যের জন্য, রাস্তার দৃশ্য টাইলস দেখুন।
language

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

region

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

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

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

ডিফল্ট টাইলের টাইলের আকার এবং কভারেজ এলাকা বজায় রেখে মানচিত্র উপাদানগুলির আকার (যেমন রাস্তার লেবেল) স্কেল-আপ করুন। স্কেল বাড়ানোর ফলে মানচিত্রের লেবেলের সংখ্যাও হ্রাস পায়, যা বিশৃঙ্খলা হ্রাস করে। নিম্নলিখিত মানগুলি বৈধ scale মান:

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

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

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

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

layerRoadmap
যদি আপনি মানচিত্রের ধরন হিসাবে terrain নির্দিষ্ট করেন তাহলে প্রয়োজনীয়৷ এছাড়াও satellite মানচিত্রের প্রকারে ঐচ্ছিকভাবে ওভারলেড করা যেতে পারে। রোডম্যাপ টাইলস কোন প্রভাব আছে.
layerStreetview
মানচিত্রে নীল রূপরেখা ব্যবহার করে রাস্তার দৃশ্য-সক্ষম রাস্তা এবং অবস্থানগুলি দেখায়৷
layerTraffic
বর্তমান ট্রাফিক অবস্থা প্রদর্শন করে।
styles

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

overlay

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

উদাহরণস্বরূপ, একটি layerRoadmap স্তর সহ একটি satellite মানচিত্রের প্রকারের অনুরোধ করা এবং মানচিত্র জাভাস্ক্রিপ্ট 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" }
      ]
    }
  ]
}

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

apiOptions : প্রয়োগ করার জন্য অতিরিক্ত বিকল্পগুলি নির্দিষ্ট করে মানগুলির একটি অ্যারে৷ সমর্থিত বিকল্পগুলি হল:

  • MCYJ5E517XR2JC - নতুন মানচিত্রের শৈলীতে অপ্ট-ইন করুন৷ অপ্ট-ইন সময়কালে, আপনার অনুরোধগুলি বিদ্যমান শৈলী পাবে যদি না এই মানটি নির্দিষ্ট করা থাকে।

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

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

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

নিম্নলিখিত তালিকায় প্রতিক্রিয়া বডিতে ক্ষেত্রগুলির সংজ্ঞা রয়েছে।

session
একটি সেশন টোকেন মান যা আপনাকে অবশ্যই আপনার সমস্ত মানচিত্র টাইলস API অনুরোধে অন্তর্ভুক্ত করতে হবে।
expiry
একটি স্ট্রিং যাতে টোকেনের মেয়াদ শেষ হওয়ার সময় (যুগ থেকে সেকেন্ডে) থাকে। একটি সেশন টোকেন তার তৈরির সময় থেকে দুই সপ্তাহের জন্য বৈধ, কিন্তু এই নীতি বিজ্ঞপ্তি ছাড়াই পরিবর্তিত হতে পারে।
tileWidth
টাইলসের প্রস্থ পিক্সেলে পরিমাপ করা হয়।
tileHeight
টাইলসের উচ্চতা পিক্সেলে পরিমাপ করা হয়।
imageFormat
চিত্র বিন্যাস, যা png বা jpeg হতে পারে।