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

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

স্ট্রিট ভিউ টাইলসের উদাহরণ

স্ট্রিট ভিউ টাইলসগুলো 2D টাইলসের মতোই, তবে এগুলোতে রাস্তার স্তর থেকে তোলা প্যানোরামিক চিত্র থাকে। স্ট্রিট ভিউয়ের মাধ্যমে আপনি বিশ্বের বিভিন্ন দর্শনীয় স্থান ঘুরে দেখতে পারেন, প্রাকৃতিক বিস্ময় উপভোগ করতে পারেন এবং জাদুঘর, স্টেডিয়াম, রেস্তোরাঁ বা ছোট ব্যবসার মতো জায়গায় প্রবেশ করতে পারেন। এই এপিআই এন্ডপয়েন্টটি আপনাকে নিম্নলিখিত সুবিধাগুলো দেয়:

  • গুগল ম্যাপস স্ট্রিট ভিউ টাইলস
  • স্ট্রিট ভিউ মেটাডেটা
  • স্ট্রিট ভিউ থাম্বনেইল

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

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

একবার আপনার কাছে একটি এপিআই কী থাকলে, আপনি নিম্নলিখিত ধাপগুলি অনুসরণ করে স্ট্রিট ভিউ চিত্রাবলী অ্যাক্সেস করতে পারবেন।

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

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

  3. panoId সার্চ রেসপন্স থেকে প্যানোরামা আইডেন্টিফায়ারগুলো ব্যবহার করে নিম্নলিখিতগুলো পান:

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

    2. স্ট্রিট ভিউ থাম্বনেইল

    3. স্ট্রিট ভিউ টাইলস

স্ট্রিট ভিউ পদ্ধতি

আপনি নিম্নলিখিত চারটি পদ্ধতির যেকোনো একটি ব্যবহার করে স্ট্রিট ভিউ চিত্র এবং মেটাডেটা অ্যাক্সেস করতে পারেন।

পদ্ধতি বর্ণনা
https://tile.googleapis.com/v1/streetview/tiles স্বতন্ত্র স্ট্রিট ভিউ টাইলগুলো ফেরত দেয়। আপনি ছয়টি জুম লেভেলে স্ট্রিট ভিউ টাইলগুলো পেতে পারেন: ৫১২ পিক্সেল থেকে শুরু করে ১৩,৩১২ পিক্সেল পর্যন্ত।
https://tile.googleapis.com/v1/streetview/panoIds আপনাকে একসাথে ১০০টি পর্যন্ত অবস্থান অনুসন্ধান করার সুবিধা দেয়। ছবি আছে এমন সমস্ত অবস্থানের প্যানোরামা আইডি ফেরত দেয়।
https://tile.googleapis.com/v1/streetview/thumbnail স্ট্রিট ভিউ দৃশ্যের একটি থাম্বনেইল 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
The locations array must contain at least one set of coordinate values, but you can include more—up to a maximum of 100.
radius
radius মান (মিটারে পরিমাপ করা) প্রদত্ত অবস্থানের চারপাশের বৃত্তের ব্যাসার্ধ নির্ধারণ করে, যার মধ্যে প্যানোরামা অনুসন্ধান করা হবে। এর ডিফল্ট মান হলো ৫০ মিটার।

প্যানয়েড প্রতিক্রিয়া

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

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

You can use panoIds to:

স্ট্রিট ভিউ মেটাডেটা

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

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

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

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

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)-এর একটি মিশ্রণ থাকে। উদাহরণস্বরূপ: ২০২৩-০৫, বা ২০২৪।
copyright
কপিরাইট লেখাটি, যা আপনাকে স্ট্রিট ভিউ ছবির সাথে অ্যাট্রিবিউশন হিসেবে অবশ্যই প্রদর্শন করতে হবে।
reportProblemLink
এই স্ট্রিট ভিউ টাইলটির সমস্যা জানানোর জন্য আপনার ব্যবহারকারীদের ব্যবহারের জন্য একটি হাইপারলিঙ্ক। আপনাকে অবশ্যই এই হাইপারলিঙ্কটি ছবির নিচের ডান কোণায় প্রদর্শন করতে হবে এবং এতে "এই ছবিটির কোনো সমস্যা থাকলে জানান" এর মতো লিঙ্ক টেক্সট থাকতে হবে।
addressComponent
একটি কাঠামোগত জিওকোড যাতে প্যানোরামার ঠিকানা সম্পর্কিত বিবরণ থাকে। আরও তথ্যের জন্য, জিওকোডিং এপিআই ডকুমেন্টেশনে জিওকোডিং অনুরোধ এবং প্রতিক্রিয়া দেখুন।
links
যেসব প্যানোরামা এইটির সাথে লিঙ্ক করা আছে, সেগুলোর আইডি-র একটি তালিকা। এতে সেই হেডিংটিও রয়েছে যেখানে লিঙ্কটি পাওয়া যায়। উদাহরণস্বরূপ, যদি হেডিংটি ১৮০° হয়, তাহলে লিঙ্ক করা প্যানোরামাটি বর্তমান প্যানোরামার ঠিক দক্ষিণে অবস্থিত। মনে রাখবেন যে, প্যানোরামা আইডি-গুলির পরিবর্তনশীল প্রকৃতির কারণে, একটির বেশি ইউজার সেশনের জন্য এগুলোর উপর নির্ভর করা উচিত নয়।

স্ট্রিট ভিউ থাম্বনেইল

আপনি 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
আপনার এপিআই কী

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

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

স্ট্রিট ভিউ ছবির টাইলস

একবার আপনার কাছে একটি 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 হলো জুম লেভেল, এবং xy হলো আপনার কাঙ্ক্ষিত স্ট্রিট ভিউ টাইলের স্থানাঙ্ক । স্ট্রিট ভিউ প্যানোরামার জুম লেভেল অবশ্যই [0,5] সীমার মধ্যে হতে হবে, যেখানে 0 হলো সবচেয়ে প্রশস্ত দৃশ্যক্ষেত্র।

Zoom Level আনুমানিক দৃশ্যক্ষেত্র
৩৬০°
১৮০°
৯০°
৪৫°
২২.৫°
১১.২৫°

স্ট্রিট ভিউ টাইলসের প্রতিক্রিয়া

একটি সফল স্ট্রিট ভিউ টাইল অনুরোধ আপনার createSession রেসপন্সে নির্দিষ্ট করা ফরম্যাট ও আকারের একটি ছবি ফেরত দেয়।

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

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

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

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

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