ডিসেম্বরে সান ফ্রান্সিসকোতে আমাদের পরবর্তী Google Maps Platform ডেভেলপার কমিউনিটি ডে-তে যোগ দিন! অংশগ্রহণ করতে এখনই আবেদন করুন।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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 ছবি অ্যাক্সেস করতে পারবেন।

সেশন টোকেন পান। mapType-এর মান streetview-এ সেট করতে ভুলবেন না।
এক বা একাধিক ভৌগোলিক লোকেশনের প্যানোরামা শনাক্তকারী (panoId) পেতে সেশন টোকেন ব্যবহার করুন।
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`	নির্দিষ্ট প্যানোরামা সম্পর্কে বিস্তারিত তথ্য প্রদান করে। বিবরণের মধ্যে সংশ্লিষ্ট ঠিকানা এবং সংলগ্ন প্যানোরামার লিঙ্ক অন্তর্ভুক্ত থাকে।

Street View panoIds সার্চ

আপনি 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 টাইল অনুরোধ করা

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

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

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,5] রেঞ্জের মধ্যে হতে হবে, যেখানে 0 সবচেয়ে বড় ফিল্ড অফ ভিউকে দেখায়।

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

Street View Tiles সংক্রান্ত উত্তর

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

টাইল সংক্রান্ত অনুরোধের ফলাফল

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

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

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

কপিরাইট তথ্য

প্রতিটি Street View প্যানোরামার সাথে আপনাকে কপিরাইট সংক্রান্ত তথ্য দেখাতে হবে। The string to display can vary between panoramas. কপিরাইট সংক্রান্ত তথ্য পেতে, আপনাকে অবশ্যই Street View মেটাডেটা-এর জন্য অনুরোধ করতে হবে এবং তারপরে আপনি উত্তরের copyright ফিল্ড দেখতে পারবেন। আরও তথ্যের জন্য, ডেটা অ্যাট্রিবিউশন দেখুন।