Street View টাইল

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

Street View টাইল সংক্রান্ত উদাহরণ

Street View টাইল 2D টাইল-এর মতো তবে এতে রাস্তার লেভেলে তোলা প্যানোরামিক ছবি থাকে। Street View-এর সাহায্যে, আপনি বিশ্বের ল্যান্ডমার্ক এক্সপ্লোর করতে, প্রাকৃতিক বিস্ময়কর স্থান দেখতে এবং জাদুঘর, রঙ্গমঞ্চ, রেস্তোরাঁ বা ছোট ব্যবসার মতো জায়গার ভেতরে যেতে পারবেন। এই API এন্ডপয়েন্ট আপনাকে এগুলি অ্যাক্সেস করতে দেয়:

  • Google Maps Street View টাইল
  • Street View মেটাডেটা
  • Street View থাম্বনেল

আপনি রাস্তার লেভেল থেকে তোলা ছবির টাইল একসাথে জুড়ে দিয়ে বাস্তব জীবনের প্যানোরামিক এফেক্ট তৈরি করতে পারবেন। এছাড়াও, আপনি কোনও লোকেশনের সেটের (যেমন, কোনও রুট) জন্য ১০০টি পর্যন্ত প্যানোরামা আইডি কোয়েরি করতে এবং ক্যামেরা পজিশন সম্পর্কে আরও গভীর মেটাডেটা পেতে পারেন।

Street View টাইল একসাথে স্টিচ করার জন্য ভিউয়ার প্রয়োজন। যেমন, Street View কাস্টম প্যানোরামা ভিউয়ার।

API কী পাওয়ার পরে, আপনি এইসব ধাপ অনুসরণ করে Street View ছবি অ্যাক্সেস করতে পারবেন:

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

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

  3. panoId সার্চ রেসপন্স থেকে প্যানোরামা শনাক্তকারী ব্যবহার করে এগুলি পান:

    1. Street View মেটাডেটা। এছাড়াও, আপনি এক সেট স্থানাঙ্ক ও ব্যাসার্ধ পাস করে Street View মেটাডেটা পেতে পারেন।

    2. Street View থাম্বনেল।

    3. Street View টাইল।

Street View পদ্ধতি

আপনি নিম্নলিখিত চারটি পদ্ধতির মধ্যে একটি কল করে Street View ছবি ও মেটাডেটা অ্যাক্সেস করতে পারবেন।

পদ্ধতি বিবরণ
https://tile.googleapis.com/v1/streetview/tiles আলাদা আলাদা Street View টাইল রিটার্ন করে। আপনি Street View টাইল ছয়টি জুম লেভেলে ফিরিয়ে আনতে পারবেন: ৫১২ পিক্সেল থেকে ১৩,৩১২ পিক্সেল পর্যন্ত।
https://tile.googleapis.com/v1/streetview/panoIds আপনাকে ১০০টি লোকেশন পর্যন্ত বাল্কে সার্চ করতে দেয়। ছবি সহ সব লোকেশনের জন্য প্যানোরামা আইডি রিটার্ন করে।
https://tile.googleapis.com/v1/streetview/thumbnail Street View দৃশ্যের থাম্বনেল JPEG ছবি রিটার্ন করে। আপনাকে হেডিং, পিচ, ডাইমেনশন ও ফিল্ড অফ ভিউ প্রদান করতে দেয়। ন্যূনতম সাইজ ১৬x১৬ পিক্সেল হতে হবে। সর্বাধিক সাইজ হল ২৫০x৬০০ পিক্সেল।
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 অ্যারেতে অন্তত একটি কোঅর্ডিনেট ভ্যালুর সেট থাকতে হবে, কিন্তু আপনি আরও যোগ করতে পারেন—সর্বাধিক ১০০টি।
radius
radius ভ্যালু (মিটারে পরিমাপ করা হয়) প্রদত্ত লোকেশনের চারপাশে বৃত্তের ব্যাসার্ধকে সংজ্ঞায়িত করে যার মধ্যে প্যানোরামা সার্চ করতে হবে। ডিফল্ট মান হল ৫০ মিটার।

PanoId উত্তর

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

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

আপনি panoIds ব্যবহার করে এগুলি করতে পারবেন:

Street View মেটাডেটা

Street View মেটাডেটা সংক্রান্ত অনুরোধ প্যানোরামা সম্পর্কে তথ্য ফিরিয়ে আনে। Street View মেটাডেটা অনুরোধ হল একটি 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"

প্যানোরামা আইডি ক্ষণস্থায়ী হওয়ার কারণে, আমরা সাজেস্ট করি যে আপনি প্রাথমিক Street View মেটাডেটা অনুরোধে স্থানাঙ্কের একটি সেট এবং একটি 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"

Street View ছবির panoId পাস করুন

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
এই প্যানোরামার অনন্য আইডি। ব্যবহারকারীর একটি সেশনের থেকে বেশি সময় ধরে Panorama আইডি বৈধ থাকবে বলে ধরে নেবেন না।
lat, lng
প্যানোরামার স্থানাঙ্ক (অক্ষাংশ ও দ্রাঘিমাংশ)। এইসব ভ্যালু আপনার অনুরোধে পাঠানো কোঅর্ডিনেট থেকে আলাদা হতে পারে কারণ লোকেশনটি সবচেয়ে কাছের প্যানোরামাতে স্ন্যাপ করে।
imageHeight, imageWidth
স্টিচ করা প্যানোরামা ছবির ডাইমেনশন।
tileHeight, tileWidth
একটি প্যানোরামা টাইলের ডাইমেনশন।
heading
কম্পাসের হেডিং, উত্তর দিক থেকে ঘড়ির কাঁটার দিকে ডিগ্রিতে পরিমাপ করা হয়। হেডিং [০,৩৬০] রেঞ্জের মধ্যে দেখানো হয়, যেখানে ০ হল উত্তর দিক।
tilt
প্যানোরমার ঢাল, যা প্যানোরমার দক্ষিণ মেরু থেকে দিগন্ত পর্যন্ত ডিগ্রি হিসেবে পরিমাপ করা হয়। ফেরত দেওয়া ভ্যালু [০, ১৮০] রেঞ্জের মধ্যে থাকে। ৯০ ডিগ্রি মান থেকে বোঝা যায় যে দিগন্ত ইতিমধ্যেই প্যানোরমার নিরক্ষরেখায় অ্যালাইন করা আছে।
roll
প্যানোরামাতে দিগন্তের লেভেল ঠিক করার জন্য দৃষ্টিরেখার চারপাশে ঘড়ির কাঁটার দিকে ঘোরানো প্রয়োগ করা হয়েছে। রিটার্ন করা ভ্যালু [০, ৩৬০] রেঞ্জের মধ্যে থাকে।
imageryType
ছবির ধরন নির্দেশ করে। সঠিক ভ্যালু হল indoor ও outdoor।
date
যে তারিখে ছবিটি তোলা হয়েছে। সব ছবিতে তারিখ সংক্রান্ত ডেটা থাকে না। তবে এটি উপলভ্য হলে, এই ফিল্ডে বছর (YYYY) ও মাস (MM)-এর কম্বিনেশন থাকে। যেমন: ২০২৩-০৫ বা ২০২৪।
copyright
Street View ছবির সাথে অ্যাট্রিবিউশন হিসেবে আপনাকে যে কপিরাইট টেক্সট দেখাতে হবে।
reportProblemLink
এই Street View টাইল সংক্রান্ত সমস্যার ব্যাপারে অভিযোগ জানানোর জন্য আপনার ব্যবহারকারীদের ব্যবহার করার জন্য একটি হাইপারলিঙ্ক। আপনাকে এই হাইপারলিঙ্কটি ছবির নিচের ডানদিকের কোণে দেখাতে হবে এবং এতে অবশ্যই লিঙ্ক টেক্সট অন্তর্ভুক্ত থাকতে হবে যা "এই ছবির সাথে সম্পর্কিত সমস্যা সম্পর্কে অভিযোগ করুন" এর মতো কিছু বলে।
addressComponent
একটি স্ট্রাকচার্ড জিওকোড যা প্যানোরমার ঠিকানা সম্পর্কে বিবরণ ধারণ করে। আরও তথ্যের জন্য, জিওকোডিং অনুরোধ ও উত্তর জিওকোডিং API ডকুমেন্টেশনে দেখুন।
links
প্যানোরামা আইডির তালিকা যা এটির সাথে লিঙ্ক করা আছে। এছাড়াও, যে হেডিংয়ে লিঙ্কটি পাওয়া গেছে সেটি অন্তর্ভুক্ত থাকে। যেমন, হেডিং ১৮০° হলে, লিঙ্ক করা প্যানোরামা বর্তমান প্যানোরামার ঠিক দক্ষিণে হবে। মনে রাখবেন, প্যানোরামা আইডি ক্ষণস্থায়ী হয় বলে, একটির বেশি ব্যবহারকারী সেশনের জন্য এটির উপর নির্ভর করবেন না।

Street View থাম্বনেল

আপনি thumbnail ফর্ম্যাটে Street View ছবির অনুরোধ করতে পারেন। থাম্বনেল হল ব্যবহারকারীর দ্বারা নির্ধারিত সাইজ, হেডিং, পিচ ও ফিল্ড অফ ভিউ সহ নন-টাইল্ড ছবি। থাম্বনেল ছবির রেজোলিউশন টাইলসের চেয়ে কম এবং ফাইলের সাইজও ছোট হয়। আপনি 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"

নিচের কোডের উদাহরণটি দেখুন, যা কানাডার হুইসলার থেকে তোলা Street View ছবির থাম্বনেল ডাউনলোড করে।

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

কানাডার হুইসলারের Street View থাম্বনেল

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

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

ঐচ্ছিক প্যারামিটার

height
পিক্সেলে থাম্বনেলের উচ্চতা নির্দিষ্ট করে, যা ১৬ পিক্সেল থেকে ২৫০ পিক্সেল পর্যন্ত হতে পারে। আপনি দৈর্ঘ্য উল্লেখ না করলে, ডিফল্ট হিসেবে সর্বাধিক অনুমোদিত মান ২৫০ পিক্সেল দৈর্ঘ্য হিসেবে সেট করা হয়। আপনি যদি রেঞ্জের বাইরে কোনও ভ্যালু নির্দিষ্ট করেন, তাহলে থাম্বনেলটি নিকটতম সঠিক ভ্যালুতে স্ন্যাপ করে।
width
১৬ পিক্সেল থেকে ৬০০ পিক্সেলের মধ্যে থাম্বনেলের প্রস্থ পিক্সেলে উল্লেখ করে। আপনি প্রস্থ নির্দিষ্ট না করলে, ডিফল্ট হিসেবে সর্বাধিক অনুমোদিত ভ্যালু ৬০০ পিক্সেল সেট করা হয়। আপনি রেঞ্জের বাইরে কোনও ভ্যালু নির্দিষ্ট করলে, থাম্বনেলটি সবচেয়ে কাছাকাছি সঠিক ভ্যালুতে স্ন্যাপ করে।
pitch
উল্লম্ব অক্ষ বরাবর ক্যামেরার কোণ নির্দিষ্ট করে। সঠিক ভ্যালু -90 থেকে 90 (অন্তর্ভুক্ত) রেঞ্জের মধ্যে থাকে। ডিফল্ট ভ্যালু হল ০।
yaw
অনুভূমিক অক্ষ বরাবর ক্যামেরার দিক নির্দেশ করে। সঠিক ভ্যালু -360 থেকে 360 (অন্তর্ভুক্ত) রেঞ্জের মধ্যে থাকে। ডিফল্ট মান হল ০।
fov
অনুভূমিক ফিল্ড অফ ভিউ নির্দিষ্ট করে, যা ডিগ্রিতে প্রকাশ করা হয়, যার সর্বোচ্চ মান ১২০। নির্দিষ্ট সাইজের ভিউপোর্ট নিয়ে কাজ করার সময়, যেমন নির্দিষ্ট সাইজের Street View ছবির ক্ষেত্রে, ফিল্ড অফ ভিউ জুমকে দেখায়; যেখানে ছোট মান বেশি লেভেলের জুমকে দেখায়। ডিফল্ট ভ্যালু হল ৯০।

Street View ছবির টাইল

আপনার কাছে panoId থাকলে, আপনি Street View ইমেজ টাইল অনুরোধ করতে পারবেন। টাইল অনুরোধ হল 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 হল আপনার প্রয়োজনীয় Street View টাইলের টাইল স্থানাঙ্ক। Street View প্যানোরামায় জুম লেভেল অবশ্যই [০,৫] রেঞ্জে থাকতে হবে, যেখানে ০ সবচেয়ে বেশি ফিল্ড অফ ভিউকে বোঝায়।

জুম লেভেল আনুমানিক ফিল্ড অফ ভিউ
0 ৩৬০°
1 ১৮০°
2 ৯০°
3 ৪৫°
4 ২২.৫°
5 ১১.২৫°

Street View টাইল সংক্রান্ত উত্তর

সফল Street View টাইল অনুরোধে, আপনার createSession উত্তরে উল্লেখ করা ফর্ম্যাট ও সাইজের ছবি রিটার্ন করা হয়।

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

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

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

জুম লেভেল পাঁচে, ফুল-সাইজ প্যানোরামা ব্যবহার করা হয় এবং টাইলসে ভাগ করা হয়।

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