ভূমিকা
রাস্তার দৃশ্য স্ট্যাটিক API মেটাডেটা অনুরোধগুলি রাস্তার দৃশ্য প্যানোরামা সম্পর্কে ডেটা প্রদান করে। মেটাডেটা ব্যবহার করে, আপনি একটি প্রদত্ত অবস্থানে একটি রাস্তার দৃশ্য চিত্র উপলব্ধ আছে কিনা তা জানতে পারবেন, সেইসাথে অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক, প্যানোরামা আইডি, ছবি তোলার তারিখ এবং কপিরাইট তথ্যের প্রোগ্রাম্যাটিক অ্যাক্সেস পেতে পারেন। ইমেজ এই মেটাডেটা অ্যাক্সেস করা আপনাকে আপনার অ্যাপ্লিকেশনে ত্রুটি আচরণ কাস্টমাইজ করতে দেয়।
রাস্তার দৃশ্য স্ট্যাটিক API মেটাডেটা অনুরোধ কোনো চার্জ ছাড়াই উপলব্ধ। আপনি যখন মেটাডেটা অনুরোধ করেন তখন কোনো কোটা খরচ হয় না। আপনি যখন রাস্তার দৃশ্য স্ট্যাটিক API ব্যবহার করে একটি ছবি লোড করেন তখনই কোটা খরচ হয় ।
রাস্তার দৃশ্যের ছবি মেটাডেটা অনুরোধ করার সময়, প্যানোরামা চিত্রগুলি 50 মিটার পর্যন্ত নির্ভুল।
চিত্রের মেটাডেটা অ্যাক্সেস করুন
একটি রাস্তার দৃশ্য চিত্র মেটাডেটা অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
ইউআরএল-এ স্ট্যান্ডার্ড হিসাবে, অ্যাম্পারস্যান্ড (&) অক্ষর ব্যবহার করে সমস্ত প্যারামিটার আলাদা করা হয়।
মেটাডেটা অনুরোধের জন্য প্রয়োজনীয় পরামিতি
মেটাডেটা অনুরোধগুলি রাস্তার দৃশ্য স্ট্যাটিক API চিত্রের অনুরোধগুলির মতো একই URL প্যারামিটারগুলি গ্রহণ করে, যদিও শুধুমাত্র নিম্নলিখিত প্যারামিটারগুলির প্রয়োজন হয়:
হয়:
-
location
— হয় একটি টেক্সট স্ট্রিং হতে পারে (যেমনChagrin Falls, OH
) অথবা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্কের একটি কমা দ্বারা পৃথক জোড়া (40.457375,-80.009353
)।
বা:
-
pano
- একটি নির্দিষ্ট প্যানোরামা আইডি। প্যানোরামাগুলি সময়ের সাথে সাথে আইডি পরিবর্তন করতে পারে, তাই এই আইডিটি ধরে রাখবেন না৷ পরিবর্তে, অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক সংরক্ষণ করুন যাতে আপনি প্যানোরামা আইডি রিফ্রেশ করতে পারেন। বিশদ বিবরণের জন্য, মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন দেখুন।
পাশাপাশি:
-
key
এবংsignature
— অনুরোধটি প্রমাণীকরণের জন্য API কী প্রয়োজন। ডিজিটাল স্বাক্ষরও কিছু নির্দিষ্ট ক্ষেত্রে প্রয়োজন এবং সর্বদা সুপারিশ করা হয়। আরও তথ্যের জন্য, একটি কী এবং স্বাক্ষর পান দেখুন।
আপনার মেটাডেটা অনুরোধ, শুধুমাত্র প্রয়োজনীয় পরামিতি সহ, এইরকম দেখায়:
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
বা এই মত:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন
আপনি যদি একটি প্যানোরামা আইডি পুনরুদ্ধার করার চেষ্টা করেন এবং হয় ZERO_RESULTS
বা কোনও মান না পান, তাহলে প্যানোরামা আইডিটি মুছে ফেলা হয়েছে এবং রিফ্রেশ করতে হবে৷
অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্কগুলি সংরক্ষণ করুন যেগুলি আপনি একটি প্যানোরামা আইডি পেতে ব্যবহার করেছিলেন যাতে প্রয়োজনের সময় আপনি রিফ্রেশ করতে পারেন৷
যখন আপনি সনাক্ত করেন যে একটি প্যানোরামা আইডি পরিবর্তিত হয়েছে, তখন সেই অবস্থানের নিকটতম প্যানোরামাগুলির জন্য আবার অনুসন্ধান করতে আসল অবস্থান ঠিকানা বা অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করুন এবং একটি নতুন প্যানোরামা আইডি পান৷
মেটাডেটা অনুরোধের জন্য ঐচ্ছিক পরামিতি
আপনি আপনার মেটাডেটা অনুরোধে নিম্নলিখিত পরামিতিগুলি অন্তর্ভুক্ত করতে পারেন: size
, heading
, fov
, এবং pitch
৷ মনে রাখবেন যে এই প্যারামিটারগুলি প্যানোরামা সম্পর্কে ডেটাকে প্রভাবিত করে না বা কোন প্যানোরামা পাওয়া যায়৷ API একটি নির্দিষ্ট চিত্রের অনুরোধের সাথে সম্পর্কিত একটি মেটাডেটা অনুরোধ তৈরি করা সহজ করার জন্য চিত্রের অনুরোধের মতো একই পরামিতিগুলি অন্তর্ভুক্ত করার অনুমতি দেয়, কিন্তু মেটাডেটা অনুরোধের জন্য, API ঐচ্ছিক পরামিতি এবং তাদের মানগুলিকে উপেক্ষা করে৷ এই প্যারামিটারগুলি ব্যবহার করার বিষয়ে তথ্যের জন্য, রাস্তার দৃশ্য স্ট্যাটিক API বিকাশকারীর নির্দেশিকা দেখুন।
প্রতিক্রিয়া বিন্যাস
মেটাডেটা প্রতিক্রিয়া শুধুমাত্র JSON ফর্ম্যাটে ফেরত দেওয়া হয়।
উদাহরণ
উদাহরণ 1: প্যানোরামা পাওয়া গেছে
নিম্নলিখিত URLগুলি সফলভাবে একই প্যানোরামার মেটাডেটা এবং চিত্রের জন্য অনুরোধ করে৷
মেটাডেটা অনুরোধ এবং প্রতিক্রিয়া
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "copyright" : "© 2017 Google", "date" : "2016-05", "location" : { "lat" : 48.85783227207914, "lng" : 2.295226175151347 }, "pano_id" : "tu510ie_z4ptBZYo2BGEJg", "status" : "OK" }
চিত্রের অনুরোধ এবং প্রতিক্রিয়া, যেখানে অনুপস্থিত চিত্র প্রত্যাশিত।
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
উদাহরণ 2: প্যানোরামা পাওয়া যায়নি
নিম্নলিখিত URLগুলি একটি প্যানোরামার জন্য মেটাডেটা এবং চিত্রের অনুরোধ করে যা নির্দিষ্ট স্থানে বা কাছাকাছি পাওয়া যায়নি৷
মেটাডেটা অনুরোধ এবং প্রতিক্রিয়া
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "status" : "ZERO_RESULTS" }
চিত্রাবলী অনুরোধ এবং প্রতিক্রিয়া
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
স্ট্যাটাস কোড
মেটাডেটা রেসপন্স অবজেক্টের মধ্যে থাকা status
ফিল্ডে অনুরোধের স্ট্যাটাস থাকে এবং রাস্তার দৃশ্যের অনুরোধ কেন কাজ করছে না তার সমস্যা সমাধানে সাহায্য করার জন্য এতে ডিবাগিং তথ্য থাকতে পারে। status
ক্ষেত্রে নিম্নলিখিত মান থাকতে পারে:
স্ট্যাটাস | বর্ণনা |
---|---|
"OK" | নির্দেশ করে যে কোন ত্রুটি ঘটেনি; একটি প্যানোরামা পাওয়া যায় এবং মেটাডেটা ফেরত দেওয়া হয়। |
"ZERO_RESULTS" | নির্দেশ করে যে প্রদত্ত অবস্থানের কাছাকাছি কোনো প্যানোরামা পাওয়া যায়নি। আপনি যদি একটি অস্তিত্বহীন বা অবৈধ প্যানোরামা আইডি প্রদান করেন তাহলে এই প্রতিক্রিয়া ঘটতে পারে৷ [মুছে ফেলা প্যানোরামা আইডি রিফ্রেশ করুন](#refresh-pano) দেখুন। |
"NOT_FOUND" | নির্দেশ করে যে location প্যারামিটারে দেওয়া ঠিকানা স্ট্রিং খুঁজে পাওয়া যায়নি। এই বার্তাটি ঘটতে পারে যদি একটি অস্তিত্বহীন ঠিকানা দেওয়া হয়। |
"OVER_QUERY_LIMIT" | নির্দেশ করে যে আপনি এই API-এর জন্য আপনার দৈনিক কোটা বা প্রতি-সেকেন্ডের কোটা অতিক্রম করেছেন। |
"REQUEST_DENIED" | নির্দেশ করে যে আপনার অনুরোধ প্রত্যাখ্যান করা হয়েছে। এই বার্তাটি ঘটতে পারে যদি আপনি আপনার অনুরোধ অনুমোদন না করেন, অথবা যদি আপনার API কী ধারণকারী Google ক্লাউড কনসোল প্রকল্পে রাস্তার দৃশ্য স্ট্যাটিক API সক্রিয় না হয়। |
"INVALID_REQUEST" | সাধারণত নির্দেশ করে যে ক্যোয়ারী প্যারামিটার (ঠিকানা, অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক, বা উপাদান) অনুপস্থিত। |
"UNKNOWN_ERROR" | নির্দেশ করে যে সার্ভার ত্রুটির কারণে অনুরোধটি প্রক্রিয়া করা যায়নি। এই সমস্যা প্রায়ই অস্থায়ী হয়. আপনি আবার চেষ্টা করলে অনুরোধ সফল হতে পারে। |
আরও তথ্য
রাস্তার দৃশ্য স্ট্যাটিক API, বা অন্যান্য Google মানচিত্র API পণ্যগুলি ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, মানচিত্র API সমর্থন পৃষ্ঠাটি দেখতে ভুলবেন না।