Street View इमेज का अनुरोध, इस फ़ॉर्मैट में एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/streetview?parameters
इमेज के बारे में जानकारी देने के लिए, अनुरोध पैरामीटर का इस्तेमाल किया जाता है. यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है. इस्तेमाल किए जा सकने वाले पैरामीटर और उनकी संभावित वैल्यू नीचे दी गई हैं.
ज़रूरी पैरामीटर
ऐसे में, आप या तो:
location, टेक्स्ट स्ट्रिंग (जैसे किChagrin Falls, OH) या अक्षांश और देशांतर निर्देशांक (40.457375,-80.009353) में से कोई एक हो सकता है. साथ ही, इसे यूआरएल-एन्कोड किया जाना चाहिए. इसलिए, अनुरोध भेजने से पहले, "सिटी हॉल, न्यूयॉर्क, NY" जैसे पतों को "सिटी+हॉल,न्यू+यॉर्क,NY" में बदलें. Street View Static API, जगह के सबसे करीब मौजूद पैनोरामिक फ़ोटो पर स्नैप करता है. पते की टेक्स्ट स्ट्रिंग देने पर, एपीआई तय की गई जगह को बेहतर तरीके से दिखाने के लिए, कैमरे की किसी दूसरी जगह का इस्तेमाल कर सकता है. अक्षांश और देशांतर के निर्देशांक देने पर, एपीआई उस जगह के आस-पास की 50 मीटर की त्रिज्या में मौजूद फ़ोटो खोजता है. Street View की इमेज समय-समय पर रीफ़्रेश होती रहती हैं. साथ ही, हर बार थोड़ी अलग जगह से फ़ोटो ली जा सकती हैं. इसलिए, ऐसा हो सकता है कि इमेज अपडेट होने पर, आपकाlocationकिसी दूसरे पैनोरमा पर स्नैप हो जाए.
या:
pano, पैनोरामा का कोई खास आईडी है. पैनोरमा का आईडी समय के साथ बदल सकता है. इसलिए, इस आईडी को सेव न करें. इसके बजाय, जगह का पता या अक्षांश और देशांतर के निर्देशांक सेव करें, ताकि पैनोरमा आईडी को रीफ़्रेश किया जा सके. ज़्यादा जानकारी के लिए, मिटाए गए पैनोरमा आईडी रीफ़्रेश करना लेख पढ़ें.
साथ ही:
sizeसे, इमेज के आउटपुट साइज़ की जानकारी पिक्सल में मिलती है. साइज़ को{width}x{height}के तौर पर तय किया जाता है - उदाहरण के लिए,size=600x400ऐसी इमेज दिखाता है जिसकी चौड़ाई 600 पिक्सल और ऊंचाई 400 पिक्सल है.keyकी मदद से, Google Cloud Console में अपने ऐप्लिकेशन के एपीआई के इस्तेमाल पर नज़र रखी जा सकती है. साथ ही, यह पक्का किया जा सकता है कि ज़रूरत पड़ने पर Google आपसे आपके ऐप्लिकेशन के बारे में संपर्क कर सके. ज़्यादा जानकारी के लिए, कुंजी और हस्ताक्षर पाना लेख पढ़ें.
मिटाए गए पैनोरमा आईडी रीफ़्रेश करना
अगर पैनोरमा आईडी पाने की कोशिश करने पर आपको ZERO_RESULTS या कोई वैल्यू नहीं मिलती है, तो इसका मतलब है कि पैनोरमा आईडी मिटा दिया गया है और उसे रीफ़्रेश करना होगा.
पैनोरमा आईडी पाने के लिए इस्तेमाल किए गए जगह के पते या अक्षांश और देशांतर के निर्देशांक सेव करें, ताकि ज़रूरत पड़ने पर उन्हें रीफ़्रेश किया जा सके.
जब आपको पता चलता है कि किसी पैनोरमा का आईडी बदल गया है, तो उस जगह के मूल पते या अक्षांश और देशांतर के निर्देशांक का इस्तेमाल करके, उस जगह के आस-पास के पैनोरमा फिर से खोजें और नया पैनोरमा आईडी पाएं.
ज़रूरी नहीं पैरामीटर
signature(सुझाया गया) एक डिजिटल हस्ताक्षर है. इसका इस्तेमाल, यह पुष्टि करने के लिए किया जाता है कि आपकी एपीआई पासकोड का इस्तेमाल करके अनुरोध जनरेट करने वाली किसी भी साइट के पास ऐसा करने की अनुमति है या नहीं. जिन अनुरोधों में डिजिटल हस्ताक्षर शामिल नहीं होता है वे शायद पूरा न हों. ज़्यादा जानकारी के लिए, कुंजी और हस्ताक्षर पाना लेख पढ़ें.ध्यान दें: Google Maps Platform के Premium प्लान के पुराने ग्राहकों के लिए, डिजिटल हस्ताक्षर करना ज़रूरी है. प्रीमियम प्लान के ग्राहकों के लिए पुष्टि करने के पैरामीटर के बारे में ज़्यादा जानें.
heading, कैमरे के कंपास हेडिंग की जानकारी देता है.0से360तक की वैल्यू इस्तेमाल की जा सकती हैं (दोनों वैल्यू उत्तर की ओर इशारा करती हैं.90पूर्व की ओर और180दक्षिण की ओर). अगर आपने कोई हेडिंग नहीं दी है, तो एक वैल्यू का हिसाब लगाया जाता है. इससे कैमरे को उसlocationपर ले जाया जाता है जहां से सबसे करीब की फ़ोटो ली गई थी.fov(डिफ़ॉल्ट तौर पर90) डिग्री में, इमेज के हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू का पता लगाता है. इसकी ज़्यादा से ज़्यादा वैल्यू120हो सकती है. तय साइज़ के व्यूपोर्ट के साथ काम करते समय, जैसे कि तय साइज़ की स्ट्रीट व्यू इमेज के साथ, फ़ील्ड ऑफ़ व्यू में ज़ूम दिखता है. इसमें छोटी संख्याएं, ज़्यादा लेवल के ज़ूम को दिखाती हैं.
(बाईं ओर:fov=120; दाईं ओर:fov=20)pitch(डिफ़ॉल्ट तौर पर0) इससे पता चलता है कि Street View वाहन के मुकाबले, कैमरे का ऐंगल ऊपर या नीचे है. यह अक्सर, लेकिन हमेशा नहीं, फ्लैट हॉरिज़ॉन्टल होता है. पॉज़िटिव वैल्यू, कैमरे को ऊपर की ओर ऐंगल करती हैं.90डिग्री, सीधे ऊपर की ओर ऐंगल करने के लिए इस्तेमाल किया जाता है. नेगेटिव वैल्यू, कैमरे को नीचे की ओर ऐंगल करती हैं.-90डिग्री, सीधे नीचे की ओर ऐंगल करने के लिए इस्तेमाल किया जाता है.radius(डिफ़ॉल्ट तौर पर50) मीटर में बताई गई त्रिज्या सेट करता है. इसमें दिए गए अक्षांश और देशांतर के केंद्र में, पैनोरमा खोजा जाता है. मान्य वैल्यू, गैर-ऋणात्मक पूर्णांक होनी चाहिए.return_error_codeसे पता चलता है कि कोई इमेज न मिलने (404 नहीं मिली) या अमान्य अनुरोध (400 गलत अनुरोध) के जवाब में, एपीआई को गड़बड़ी का कोड दिखाना चाहिए या नहीं. मान्य वैल्यूtrueऔरfalseहैं. अगर इसेtrueपर सेट किया जाता है, तो सामान्य स्लेटी इमेज के बजाय, गड़बड़ी का मैसेज दिखता है. इससे, इमेज की उपलब्धता की जांच करने के लिए, अलग से कॉल करने की ज़रूरत नहीं पड़ती.source(डिफ़ॉल्ट रूप सेdefault) Street View पर खोज के नतीजों को चुनिंदा सोर्स तक सीमित करता है. मान्य वैल्यू ये हैं:default, Street View के लिए डिफ़ॉल्ट सोर्स का इस्तेमाल करता है; खोजें, खास सोर्स तक सीमित नहीं होतीं.outdoor, खोज को सिर्फ़ आउटडोर कलेक्शन तक सीमित करता है. इनडोर कलेक्शन, खोज के नतीजों में शामिल नहीं किए जाते. ध्यान दें कि हो सकता है कि चुनी गई जगह के लिए, बाहरी पैनोरमा मौजूद न हों. यह भी ध्यान रखें कि खोज के नतीजों में सिर्फ़ ऐसे पैनोरमा दिखते हैं जिनसे यह पता चलता हो कि वे अंदर की तस्वीरें हैं या बाहर की. उदाहरण के लिए, फ़ोटोस्फ़ीर की जानकारी नहीं मिलती, क्योंकि यह पता नहीं चलता कि वे इनडोर हैं या आउटडोर.
अनुरोध का यह एक उदाहरण है.
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 स्टैटिक एपीआई, एक धूसर रंग की जेनरिक इमेज दिखाता है. साथ ही, उसमें "माफ़ करें, हमारे पास यहां कोई इमेज नहीं है" टेक्स्ट दिखता है. इस उदाहरण में दिखाया गया है:
सिर्फ़ मान्य इमेज दिखाना
सामान्य इमेज दिखाने से बचने और यह पक्का करने के लिए कि आपके वेब पेज पर सिर्फ़ मान्य Street View स्टैटिक एपीआई इमेज दिखें, इन सुझावों का पालन करें:
return_error_codeपैरामीटर कोtrueपर सेट करें. अगर बताई गई जगह के लिए कोई इमेज उपलब्ध नहीं है, तो Street View स्टैटिक एपीआई, सामान्य स्लेटी इमेज के बजाय 404 नहीं मिला गड़बड़ी का मैसेज दिखाता है.- Street View इमेज का मेटाडेटा पाने का अनुरोध करें, ताकि यह पता लगाया जा सके कि किसी जगह के लिए इमेज उपलब्ध है या नहीं. ऐसा, अनुरोध भेजने से पहले करें.