রাস্তার দৃশ্য টাইলস

রাস্তার দৃশ্যের উদাহরণ রাস্তার দৃশ্যের টাইলগুলি 2D টাইলগুলির মতোই, তবে সেগুলিতে রাস্তার স্তরে তোলা প্যানোরামিক চিত্র রয়েছে৷ রাস্তার দৃশ্যের সাহায্যে, আপনি বিশ্বের ল্যান্ডমার্কগুলি অন্বেষণ করতে পারেন, প্রাকৃতিক বিস্ময় দেখতে পারেন এবং যাদুঘর, আখড়া, রেস্তোরাঁ বা ছোট ব্যবসার মতো জায়গাগুলির ভিতরে যেতে পারেন৷ এই API এন্ডপয়েন্ট আপনাকে এতে অ্যাক্সেস দেয়:

  • Google মানচিত্র রাস্তার দৃশ্য টাইলস
  • রাস্তার দৃশ্য মেটাডেটা
  • রাস্তার দৃশ্য থাম্বনেল

আপনি একটি বাস্তব-জীবনের প্যানোরামিক প্রভাব তৈরি করতে রাস্তার স্তর থেকে তোলা ছবির টাইলগুলি একসাথে সেলাই করতে পারেন৷ এবং আপনি অবস্থানগুলির একটি সেটের জন্য (যেমন একটি রুট) 100টি পর্যন্ত প্যানোরামা আইডি অনুসন্ধান করতে পারেন এবং ক্যামেরা অবস্থান সম্পর্কে আরও গভীর মেটাডেটা পেতে পারেন৷

রাস্তার দৃশ্য টাইলস একসাথে সেলাই করার জন্য একজন দর্শকের প্রয়োজন। উদাহরণস্বরূপ, রাস্তার দৃশ্য কাস্টম প্যানোরামা ভিউয়ার।

একবার আপনার কাছে একটি API কী থাকলে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করে রাস্তার দৃশ্যের চিত্রগুলি অ্যাক্সেস করতে পারেন৷

  1. একটি সেশন টোকেন পান। streetview mapType এর মান সেট করতে ভুলবেন না।

  2. এক বা একাধিক ভৌগলিক অবস্থানের প্যানোরামা শনাক্তকারী (প্যানোআইডি) পেতে সেশন টোকেন ব্যবহার করুন।

  3. পেতে প্যানোআইডি অনুসন্ধান প্রতিক্রিয়া থেকে প্যানোরামা শনাক্তকারী ব্যবহার করুন:

    1. রাস্তার দৃশ্য মেটাডেটা । আপনি স্থানাঙ্কের একটি সেট এবং একটি ব্যাসার্ধ অতিক্রম করে রাস্তার দৃশ্যের মেটাডেটাও পেতে পারেন।

    2. রাস্তার দৃশ্য থাম্বনেল

    3. রাস্তার দৃশ্য টাইলস

রাস্তার দৃশ্য পদ্ধতি

আপনি নিম্নলিখিত চারটি পদ্ধতির একটিতে কল করে রাস্তার দৃশ্যের চিত্রাবলী এবং মেটাডেটা অ্যাক্সেস করতে পারেন৷

পদ্ধতি বর্ণনা
https://tile.googleapis.com/v1/streetview/tiles পৃথক রাস্তার দৃশ্য টাইলস প্রদান করে। আপনি ছয়টি জুম স্তরে রাস্তার দৃশ্য টাইলস পুনরুদ্ধার করতে পারেন: 512 পিক্সেল থেকে, 13,312 পিক্সেল পর্যন্ত৷
https://tile.googleapis.com/v1/streetview/panoIds আপনাকে 100টি পর্যন্ত অবস্থানের জন্য বাল্কে অনুসন্ধান করতে দেয়৷ চিত্র সহ সমস্ত অবস্থানের জন্য প্যানোরামা আইডি প্রদান করে৷
https://tile.googleapis.com/v1/streetview/thumbnail একটি রাস্তার দৃশ্য দৃশ্যের একটি থাম্বনেইল JPEG চিত্র প্রদান করে৷ আপনাকে একটি শিরোনাম, পিচ, মাত্রা এবং দৃশ্যের ক্ষেত্র প্রদান করতে দেয়। ন্যূনতম মাত্রা হল 16x16 পিক্সেল। সর্বাধিক মাত্রা হল 250x600 পিক্সেল।
https://tile.googleapis.com/v1/streetview/metadata নির্দিষ্ট প্যানোরামা সম্পর্কে বিস্তারিত তথ্য প্রদান করে। বিশদ সম্পর্কিত ঠিকানা, এবং সংলগ্ন প্যানোরামাগুলির লিঙ্কগুলি অন্তর্ভুক্ত করে৷

আপনি panoIds পদ্ধতিতে স্থানাঙ্ক ( lat , lng ) পাস করে এক বা একাধিক ভৌগলিক অবস্থানের প্যানোরামা শনাক্তকারী খুঁজে পেতে পারেন। অনুরোধের মূল অংশটি হল একটি JSON অবজেক্ট যাতে একটি locations অ্যারে এবং ঐচ্ছিকভাবে, একটি radius রয়েছে, যা নিম্নলিখিত JSON কোড উদাহরণে দেখানো হয়েছে।

curl -X POST -d '{
  "locations": [
    {"lat": -33.883837, "lng": 151.209307},
    {"lat": -33.883700, "lng": 151.210307},
    {"lat": 0, "lng": 0}
  ],
  "radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"
locations
locations বিন্যাসে স্থানাঙ্ক মানগুলির অন্তত একটি সেট থাকতে হবে, তবে আপনি আরও অন্তর্ভুক্ত করতে পারেন—সর্বোচ্চ 100 পর্যন্ত।
radius
radius মান (মিটারে পরিমাপ করা) প্রদত্ত অবস্থানের চারপাশে বৃত্তের ব্যাসার্ধকে সংজ্ঞায়িত করে, যেখানে প্যানোরামাগুলি অনুসন্ধান করতে হবে। ডিফল্ট মান 50 মিটার।

প্যানোআইডি প্রতিক্রিয়া

ম্যাপ টাইলস API প্রতিটি অবস্থানের সবচেয়ে কাছের প্যানোরামা খুঁজে বের করার চেষ্টা করে এবং তারপর এটি তাদের প্যানোরামা আইডি ফেরত দেয়। একটি সফল panoIds অনুরোধ একটি panoIds অ্যারে ধারণ করে এমন একটি JSON অবজেক্ট ফেরত দেয়। অ্যারেতে প্যানোরামা আইডিগুলির একটি তালিকা রয়েছে, যে ক্রমে আপনি তাদের অনুরোধ করেছেন৷ যদি ম্যাপ টাইলস API আপনার অনুরোধ করা অবস্থানগুলির জন্য কোনো প্যানোরামা খুঁজে না পায়, তাহলে অ্যারের সেই অবস্থানে একটি খালি স্ট্রিং ফেরত দেওয়া হয়। একটি উদাহরণের জন্য, নিম্নলিখিত JSON কোড দেখুন।

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

আপনি panoIds ব্যবহার করতে পারেন:

রাস্তার দৃশ্য মেটাডেটা

রাস্তার দৃশ্য মেটাডেটা প্যানোরামা সম্পর্কে তথ্য পুনরুদ্ধারের অনুরোধ করে। একটি রাস্তার দৃশ্য মেটাডেটা অনুরোধ হল একটি HTTPS GET অনুরোধ৷ আপনি দুটি উপায়ে প্যানোরামা সম্পর্কে তথ্য পুনরুদ্ধার করতে পারেন:

  • আপনি যদি একটি pano_id পাস করেন, তাহলে Map Tiles API সেই প্যানোরামার মেটাডেটা ফেরত দেয়।

  • কিন্তু যদি আপনি একটি lat এবং lng পাস করেন, তাহলে Map Tiles API প্রদত্ত অনুসন্ধান ব্যাসার্ধের মধ্যে নিকটতম প্যানোরামার জন্য মেটাডেটা প্রদান করে।

স্থানাঙ্ক এবং একটি ব্যাসার্ধের একটি সেট পাস করুন

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

যেহেতু প্যানোরামা আইডিগুলি ক্ষণস্থায়ী, তাই আমরা সুপারিশ করি যে আপনি আপনার প্রাথমিক রাস্তার দৃশ্য মেটাডেটা অনুরোধে স্থানাঙ্কের একটি সেট এবং একটি radius মান পাস করুন৷ একটি উদাহরণের জন্য, নিম্নলিখিত কোড স্নিপেট দেখুন।

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

একটি রাস্তার দৃশ্য চিত্রের প্যানোআইডি পাস করুন

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

মেটাডেটা প্রতিক্রিয়া

নিম্নলিখিত JSON কোডটি একটি সাধারণ মেটাডেটা প্রতিক্রিয়ার উদাহরণ।

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
 "addressComponents": [
  {
   "longName": "United States",
   "shortName": "United States",
   "types": [
    "country"
   ]
  },
  {
   "longName": "Mountain View, California",
   "shortName": "Mountain View, California",
   "types": [
    "locality"
   ]
  },
  {
   "longName": "Charleston Rd",
   "shortName": "Charleston Rd",
   "types": [
    "route"
   ]
  },
  {
   "longName": "1635",
   "shortName": "1635",
   "types": [
    "street_number"
   ]
  }
 ],
 "links": [
  {
   "panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
   "heading": 274.47998046875,
   "text": "Charleston Rd"
  },
  {
   "panoId": "1cODYwFRw1aZ45IignDIMw",
   "heading": 94.47999572753906,
   "text": "Charleston Rd"
  }
 ]
}

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

panoId
এই প্যানোরামার অনন্য আইডি। আপনার প্যানোরামা আইডি একটি একক ব্যবহারকারী সেশনের বেশি সময় ধরে বৈধ হওয়ার উপর নির্ভর করা উচিত নয়৷
lat , lng
প্যানোরামার স্থানাঙ্ক (অক্ষাংশ এবং দ্রাঘিমাংশ)। এই মানগুলি আপনার অনুরোধে পাস করা স্থানাঙ্কের থেকে আলাদা হতে পারে কারণ অবস্থানটি নিকটতম প্যানোরামায় আসে
imageHeight , imageWidth
সেলাই করা প্যানোরামা ছবির মাত্রা।
tileHeight , tileWidth
একটি একক প্যানোরামা টাইলের মাত্রা।
heading
কম্পাস শিরোনাম, ডিগ্রী মাপা, উত্তর থেকে ঘড়ির কাঁটার দিকে। শিরোনামগুলি [0,360] পরিসরের মধ্যে ফেরত দেওয়া হয়, 0টি উত্তরের প্রতিনিধিত্ব করে।
tilt
প্যানোরামার কাত, প্যানোরামার দক্ষিণ মেরু থেকে দিগন্ত পর্যন্ত ডিগ্রীতে পরিমাপ করা হয়। প্রত্যাবর্তিত মানগুলি [0, 180] সীমার মধ্যে রয়েছে৷ 90 ডিগ্রীর মান নির্দেশ করে যে দিগন্ত ইতিমধ্যেই প্যানোরামার বিষুব রেখায় সারিবদ্ধ।
roll
দৃষ্টিরেখার চারপাশে ঘড়ির কাঁটার ঘূর্ণন যা দিগন্ত সমতল করতে প্যানোরামাতে প্রয়োগ করা হয়েছিল। প্রত্যাবর্তিত মানগুলি [0, 360] সীমার মধ্যে রয়েছে৷
imageryType
চিত্রের ধরন নির্দেশ করে। বৈধ মান indoor এবং outdoor হয়.
date
ছবি তোলার তারিখ। সব ছবিতেই তারিখের ডেটা নেই। কিন্তু যখন এটি উপলব্ধ হয়, তখন এই ক্ষেত্রটিতে বছর (YYYY) এবং মাস (MM) এর সমন্বয় থাকে। উদাহরণস্বরূপ: 2023-05, বা 2024।
copyright
কপিরাইট টেক্সট যা আপনাকে অবশ্যই স্ট্রীট ভিউ ছবির সাথে অ্যাট্রিবিউশন হিসেবে প্রদর্শন করতে হবে।
reportProblemLink
আপনার ব্যবহারকারীদের এই রাস্তার দৃশ্য টাইলের সমস্যার রিপোর্ট করার জন্য ব্যবহার করার জন্য একটি হাইপারলিঙ্ক৷ আপনাকে অবশ্যই এই হাইপারলিঙ্কটি চিত্রের নীচের ডানদিকের কোণায় প্রদর্শন করতে হবে এবং এতে অবশ্যই লিঙ্ক পাঠ্য অন্তর্ভুক্ত থাকতে হবে যা "এই চিত্রটির সাথে একটি সমস্যা প্রতিবেদন করুন" এর মতো কিছু বলে।
addressComponent
একটি স্ট্রাকচার্ড জিওকোড যাতে প্যানোরামার ঠিকানা সম্পর্কে বিশদ বিবরণ রয়েছে৷ আরও তথ্যের জন্য, জিওকোডিং এপিআই ডকুমেন্টেশনে জিওকোডিং অনুরোধ এবং প্রতিক্রিয়া দেখুন।
links
প্যানোরামা আইডিগুলির একটি তালিকা যা এটির সাথে লিঙ্ক করে৷ লিঙ্কটি পাওয়া যায় এমন শিরোনামও রয়েছে। উদাহরণস্বরূপ, যদি শিরোনামটি 180° হয়, তাহলে সংযুক্ত প্যানোরামাটি বর্তমান প্যানোরামার দক্ষিণে রয়েছে৷ মনে রাখবেন যে প্যানোরামা আইডিগুলির ক্ষণস্থায়ী প্রকৃতির কারণে, আপনার একক ব্যবহারকারীর সেশনের বেশি এইগুলির উপর নির্ভর করা উচিত নয়৷

রাস্তার দৃশ্য থাম্বনেল

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

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId&height=FROM_16_TO_250&width=FROM_16_TO_600&pitch=FROM-90_TO_90&yaw=FROM-360_TO_360&fov=FROM_30_TO_120"

নিম্নলিখিত কোড উদাহরণটি বিবেচনা করুন, যা কানাডার হুইসলারে তোলা রাস্তার দৃশ্য চিত্রের একটি থাম্বনেইল ডাউনলোড করে৷

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=Zzl28rqGJgaL2IdkUleP8A&height=200&width=200&pitch=0&yaw=250&fov=80" --output /tmp/example_thumbnail.png

কানাডার হুইসলারের রাস্তার দৃশ্য থাম্বনেল

প্রয়োজনীয় পরামিতি

panoId
আপনি যে থাম্বনেইলের অনন্য আইডি চান। আপনি প্যানোরামা আইডি মানগুলি panoIds এন্ডপয়েন্ট থেকে বা metadata এন্ডপয়েন্ট থেকে পেতে পারেন — উভয়ই ভৌগলিক স্থানাঙ্ক গ্রহণ করে এবং উপযুক্ত panoId ফেরত দেয়।
session
একটি বৈধ সেশন টোকেন
key
আপনার API কী

ঐচ্ছিক পরামিতি

height
থাম্বনেইলের উচ্চতা পিক্সেলে নির্দিষ্ট করে, 16 পিক্সেল থেকে 250 পিক্সেল পর্যন্ত। আপনি যদি একটি উচ্চতা নির্দিষ্ট না করেন, তাহলে উচ্চতা ডিফল্ট সর্বোচ্চ অনুমোদিত মান 250 পিক্সেল। যদি আপনি একটি মান নির্দিষ্ট করেন যা পরিসীমার বাইরে, তাহলে থাম্বনেইলটি নিকটতম বৈধ মানের সাথে স্ন্যাপ করে
width
থাম্বনেইলের প্রস্থ পিক্সেলে নির্দিষ্ট করে, 16 পিক্সেল থেকে 600 পিক্সেল পর্যন্ত। যদি আপনি একটি প্রস্থ নির্দিষ্ট না করেন, তাহলে প্রস্থ ডিফল্ট সর্বোচ্চ অনুমোদিত মান 600 পিক্সেল। যদি আপনি একটি মান নির্দিষ্ট করেন যা পরিসীমার বাইরে, তাহলে থাম্বনেইলটি নিকটতম বৈধ মানের সাথে স্ন্যাপ করে
pitch
উল্লম্ব অক্ষ বরাবর ক্যামেরার কোণ নির্দিষ্ট করে। বৈধ মানগুলি -90 থেকে 90 পর্যন্ত (অন্তর্ভুক্ত)। ডিফল্ট মান 0।
yaw
অনুভূমিক অক্ষ বরাবর ক্যামেরার দিক নির্দেশ করে। বৈধ মানগুলি -360 থেকে 360 পর্যন্ত (অন্তর্ভুক্ত)। ডিফল্ট মান s 0।
fov
120 এর সর্বাধিক মান সহ ডিগ্রীতে প্রকাশ করা অনুভূমিক ক্ষেত্রটি নির্দিষ্ট করে। একটি নির্দিষ্ট আকারের ভিউপোর্টের সাথে কাজ করার সময়, একটি সেট আকারের রাস্তার দৃশ্যের চিত্রের মতো, দৃশ্যের ক্ষেত্রটি জুমকে উপস্থাপন করে; যেখানে ছোট মানগুলি জুমের উচ্চ স্তরকে নির্দিষ্ট করে৷ ডিফল্ট মান 90।

রাস্তার দৃশ্য ছবির টাইলস

একবার আপনার একটি panoId হয়ে গেলে, আপনি একটি রাস্তার দৃশ্য চিত্র টাইলের অনুরোধ করতে পারেন৷ টাইল অনুরোধ হল HTTPS GET অনুরোধ। নিম্নলিখিত উদাহরণ বিবেচনা করুন.

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

এই কোডের উদাহরণে, z হল জুম স্তর, এবং x এবং y হল রাস্তার দৃশ্য টাইলের টাইল স্থানাঙ্ক যা আপনি চান। রাস্তার দৃশ্য প্যানোরামাগুলিতে জুম স্তরগুলি অবশ্যই [0,5] পরিসরে হতে হবে, যেখানে 0 বিস্তৃত দৃশ্যের ক্ষেত্রকে প্রতিনিধিত্ব করে৷

জুম লেভেল দৃশ্যের আনুমানিক ক্ষেত্র
0 360°
1 180°
2 90°
3 45°
4 22.5°
5 11.25°

রাস্তার দৃশ্য টাইলস প্রতিক্রিয়া

একটি সফল রাস্তার দৃশ্য টাইল অনুরোধ আপনার createSession প্রতিক্রিয়াতে নির্দিষ্ট করা বিন্যাস এবং আকারের একটি চিত্র প্রদান করে।

একটি সফল টাইল অনুরোধের ফলাফল

জুম লেভেল জিরোতে, পুরো প্যানোরামাটির আকার পরিবর্তন করা হয় tileWidth টাইল tileHeight দ্বারা। যেহেতু প্যানোরামাগুলি x মাত্রায় বড়, তাই টাইলে y মাত্রায় খালি স্থান থাকবে:

জুম লেভেল শূন্য

জুম লেভেল ফাইভে, পূর্ণ আকারের প্যানোরামা ব্যবহার করা হয় এবং টাইলগুলিতে বিভক্ত করা হয়।

প্রতিটি রাস্তার দৃশ্য প্যানোরামার সাথে আপনাকে অবশ্যই কপিরাইট তথ্য প্রদর্শন করতে হবে। প্রদর্শনের জন্য স্ট্রিং প্যানোরামার মধ্যে পরিবর্তিত হতে পারে। কপিরাইট তথ্য পেতে, আপনাকে অবশ্যই রাস্তার দৃশ্যের মেটাডেটা অনুরোধ করতে হবে এবং তারপর আপনি প্রতিক্রিয়ার copyright ক্ষেত্রটি উল্লেখ করতে পারেন৷ আরও তথ্যের জন্য, ডেটা অ্যাট্রিবিউশন দেখুন।