Streetview অনুরোধ ও উত্তর

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

Street View ইমেজ অনুরোধ হল এই ফর্ম্যাটে একটি HTTP URL:

https://maps.googleapis.com/maps/api/streetview?parameters

অনুরোধের প্যারামিটার ব্যবহার করে ছবি নির্দিষ্ট করা হয়। URL-এর স্ট্যান্ডার্ড অনুযায়ী, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়। অনুমোদিত প্যারামিটার এবং সেগুলির সম্ভাব্য ভ্যালু নিচে তালিকাভুক্ত করা হয়েছে।

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

এই দুটির মধ্যে কোনও একটি করুন:

  • location হয় টেক্সট স্ট্রিং (যেমন Chagrin Falls, OH) অথবা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক পেয়ার (40.457375,-80.009353) হতে পারে, এবং URL-এনকোড করা হতে হবে। তাই অনুরোধ পাঠানোর আগে "City Hall, New York, NY"-এর মতো ঠিকানা "City+Hall,New+York,NY"-তে কনভার্ট করুন। Street View Static API লোকেশনের সবচেয়ে কাছাকাছি প্যানোরামা ফটোগ্রাফে স্ন্যাপ করে। আপনি কোনও ঠিকানা টেক্সট স্ট্রিং প্রদান করলে, API নির্দিষ্ট লোকেশন আরও ভালোভাবে দেখানোর জন্য অন্য কোনও ক্যামেরা লোকেশন ব্যবহার করতে পারে। আপনি অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক প্রদান করলে, API লোকেশনটির সবচেয়ে কাছাকাছি থাকা কোনও ফটোগ্রাফের জন্য ৫০ মিটার ব্যাসার্ধের মধ্যে সার্চ করে। Street View ছবি যেহেতু নির্দিষ্ট সময় অন্তর রিফ্রেশ করা হয় এবং প্রতিবার ছবি তোলার সময় অবস্থান সামান্য আলাদা হতে পারে, তাই ছবি আপডেট করার সময় আপনার location অন্য প্যানোরামাতে স্ন্যাপ করতে পারে।

অথবা:

  • pano হল একটি নির্দিষ্ট প্যানোরামা আইডি। সময়ের সাথে সাথে প্যানোরামার আইডি পরিবর্তন হতে পারে, তাই এই আইডি সেভ করে রাখবেন না। পরিবর্তে, লোকেশনের ঠিকানা বা অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক সেভ করুন যাতে আপনি প্যানোরামা আইডি রিফ্রেশ করতে পারেন। বিস্তারিত জানতে, মুছে দেওয়া প্যানোরামা আইডি রিফ্রেশ করুন বিকল্প দেখুন।

এছাড়াও:

  • size পিক্সেলে ছবির আউটপুট সাইজ নির্দিষ্ট করে। সাইজ এইভাবে উল্লেখ করা হয় {width}x{height} - যেমন, size=600x400 ৬০০ পিক্সেল চওড়া এবং ৪০০ পিক্সেল লম্বা ছবি দেখায়।
  • key আপনাকে Google Cloud Console-এ আপনার অ্যাপ্লিকেশনের API ব্যবহার মনিটর করতে দেয় এবং প্রয়োজন হলে Google যাতে আপনার অ্যাপ্লিকেশনের ব্যাপারে আপনার সাথে যোগাযোগ করতে পারে তা নিশ্চিত করে। আরও তথ্যের জন্য, কী ও স্বাক্ষর পান দেখুন।

মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন

আপনি যদি প্যানোরামা আইডি ফিরিয়ে আনার চেষ্টা করেন এবং ZERO_RESULTS বা কোনও ভ্যালু না পান, তাহলে প্যানোরামা আইডি মুছে ফেলা হয়েছে এবং রিফ্রেশ করতে হবে।

  1. প্যানোরামা আইডি পেতে আপনি যে লোকেশনের ঠিকানা বা অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করেছেন তা সেভ করুন যাতে প্রয়োজন হলে আপনি রিফ্রেশ করতে পারেন।

  2. আপনি যখন শনাক্ত করবেন যে প্যানোরামা আইডি পরিবর্তন করা হয়েছে, তখন সেই লোকেশনের সবচেয়ে কাছের প্যানোরামাগুলি আবার সার্চ করতে এবং একটি নতুন প্যানোরামা আইডি পেতে আসল লোকেশনের ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক ব্যবহার করুন।

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

  • signature (সাজেস্ট করা হয়েছে) হল একটি ডিজিটাল স্বাক্ষর যা আপনার API কী ব্যবহার করে অনুরোধ জেনারেট করা যেকোনও সাইট এটি করার জন্য অনুমোদিত কিনা তা যাচাই করতে ব্যবহার করা হয়। ডিজিটাল স্বাক্ষর অন্তর্ভুক্ত না থাকা অনুরোধগুলি ব্যর্থ হতে পারে। আরও তথ্যের জন্য, কী ও স্বাক্ষর পান দেখুন।

    মনে রাখবেন: Google Maps Platform Premium Plan-এর পুরনো গ্রাহকদের জন্য ডিজিটাল স্বাক্ষর প্রয়োজন। প্রিমিয়াম প্ল্যান গ্রাহকদের জন্য যাচাইকরণ প্যারামিটার সম্পর্কে আরও তথ্য পান।

  • heading ক্যামেরার কম্পাস হেডিং নির্দেশ করে। গ্রহণযোগ্য ভ্যালু হল 0 থেকে 360 (উভয় ভ্যালু উত্তর দিক নির্দেশ করে, 90 পূর্ব দিক নির্দেশ করে এবং 180 দক্ষিণ দিক নির্দেশ করে)। আপনি কোনও হেডিং নির্দিষ্ট না করলে, একটি ভ্যালু হিসাব করা হয় যা ক্যামেরাকে নির্দিষ্ট location-এর দিকে নির্দেশ করে, যে পয়েন্ট থেকে সবচেয়ে কাছের ফটো তোলা হয়েছে।
  • fov (ডিফল্ট হল 90) ডিগ্রিতে প্রকাশ করা ছবির অনুভূমিক ফিল্ড অফ ভিউ নির্ধারণ করে, যার সর্বাধিক অনুমোদিত ভ্যালু হল 120। নির্দিষ্ট সাইজের ভিউপোর্ট নিয়ে কাজ করার সময়, যেমন নির্দিষ্ট সাইজের Street View ছবির ক্ষেত্রে, ফিল্ড অফ ভিউ আসলে জুমকে বোঝায়, যেখানে ছোট সংখ্যা বেশি জুম লেভেলকে নির্দেশ করে।


    অ্যাকোয়ারিয়ামের ভিতরে সিলিং, দেওয়াল, মেঝে এবং ট্যাঙ্কের জানালা সহ একটি ওয়াইড-রেঞ্জ ফিল্ড অফ ভিউয়ের স্ক্রিনশট। ক্লোজ-আপ শট ফিল্ড অফ ভিউয়ের স্ক্রিনশট, যেখানে অ্যাকোয়ারিয়ামের ভিতরে Street View ফটোর জুম-ইন করা বিবরণ দেখানো হয়েছে।
    (বাঁদিকে: fov=120; ডানদিকে: fov=20)

  • pitch (ডিফল্ট হল 0) Street View গাড়ির সাপেক্ষে ক্যামেরার উপরের বা নিচের কোণ নির্দিষ্ট করে। এটি প্রায়ই, তবে সবসময় নয়, সমতল অনুভূমিক হয়। পজিটিভ ভ্যালু ক্যামেরাকে উপরের দিকে অ্যাঙ্গেল করে (90 ডিগ্রি সোজাসুজি উপরের দিকে নির্দেশ করে); নেগেটিভ ভ্যালু ক্যামেরাকে নিচের দিকে অ্যাঙ্গেল করে (-90 সোজাসুজি নিচের দিকে নির্দেশ করে)।
  • radius (ডিফল্ট হল 50) মিটারে নির্দিষ্ট করা ব্যাসার্ধ সেট করে, যার মধ্যে প্যানোরামা সার্চ করতে হবে, প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশের উপর কেন্দ্র করে। সঠিক ভ্যালু হল নন-নেগেটিভ পূর্ণসংখ্যা।
  • return_error_code থেকে বোঝা যায় যে কোনও ছবি খুঁজে না পাওয়া গেলে (404 খুঁজে পাওয়া যায়নি) অথবা ভুল অনুরোধের (400 ভুল অনুরোধ) উত্তরে API-এর কোনও ত্রুটি কোড ফেরানো উচিত কিনা। সঠিক ভ্যালু হল true এবং false। true-এ সেট করা হলে, জেনেরিক ধূসর ছবির পরিবর্তে একটি সমস্যার মেসেজ দেখানো হয়। এর ফলে, ছবি উপলভ্য আছে কিনা তা চেক করার জন্য আলাদা করে কল করার প্রয়োজন হয় না।
  • source (ডিফল্ট হল default) Street View সার্চকে বেছে নেওয়া সোর্সের মধ্যে সীমাবদ্ধ করে। সঠিক ভ্যালু হল:
    • default Street View-এর জন্য ডিফল্ট সোর্স ব্যবহার করে; সার্চ নির্দিষ্ট সোর্সের মধ্যে সীমাবদ্ধ নয়।
    • outdoor আউটডোর কালেকশনে সার্চ সীমিত করে। সার্চ ফলাফলে ইনডোর কালেকশন অন্তর্ভুক্ত করা হয় না। মনে রাখবেন, নির্দিষ্ট লোকেশনের জন্য আউটডোর প্যানোরামা উপলভ্য নাও থাকতে পারে। এছাড়াও মনে রাখবেন যে সার্চের মাধ্যমে শুধু সেইসব প্যানোরামা দেখানো হয় যেগুলি ইনডোর নাকি আউটডোর তা নির্ধারণ করা সম্ভব। যেমন, PhotoSpheres-এর ক্ষেত্রে এটি ইনডোর নাকি আউটডোর তা জানা যায় না বলে এটি রিটার্ন করা হয় না।

এটি একটি উদাহরণ অনুরোধ।

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
রাস্তায় তোলা ফটোর সংগ্রহ থেকে নেওয়া একটি স্ক্রিনশট যেখানে বিদ্যুতায়িত রেল ট্র্যাক দেখানো হয়েছে।

কোনও চিত্রাবলী উপলভ্য নেই

যেসব লোকেশনের জন্য Street View ছবি উপলভ্য নয়, সেখানে Street View Static API "দুঃখিত, এখানে আমাদের কোনও ছবি নেই" টেক্সট সহ একটি ধূসর রঙের সাধারণ ছবি দেখায়, যেমনটি এই উদাহরণে দেখানো হয়েছে:

নির্দিষ্ট লোকেশনের জন্য কোনও ছবি উপলভ্য না থাকলে, সাধারণ ছবির স্ক্রিনশট দেখানো হয়। ব্যাকগ্রাউন্ড হালকা বাদামী রঙের এবং সেখানে 'দুঃখিত, এখানে কোনও ছবি নেই' টেক্সট লেখা আছে।
ছবি: নির্দিষ্ট লোকেশনের জন্য কোনও ছবি উপলভ্য না থাকলে জেনেরিক ছবি দেখানো হয়।

শুধুমাত্র সঠিক ছবি দেখান

জেনেরিক ছবি দেখানো এড়াতে এবং আপনার ওয়েব পেজ যাতে শুধু সঠিক Street View Static API ছবি দেখায় তা নিশ্চিত করতে, এইসব সাজেশন অনুসরণ করুন:

  • return_error_code প্যারামিটার true-এ সেট করুন। এর ফলে, নির্দিষ্ট লোকেশনের জন্য কোনও ছবি উপলভ্য না থাকলে, Street View Static API, সাধারণ ধূসর ছবির পরিবর্তে 404 NOT FOUND সমস্যা দেখায়।
  • অনুরোধ পাঠানোর আগে নির্দিষ্ট লোকেশনের জন্য ছবি উপলভ্য আছে কিনা তা নির্ধারণ করতে Street View ছবির মেটাডেটা অনুরোধ করুন।