Street View इमेज का अनुरोध, इस फ़ॉर्मैट में एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/streetview?parameters
इमेज के बारे में जानकारी देने के लिए, अनुरोध के पैरामीटर का इस्तेमाल किया जाता है. यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है. इस्तेमाल किए जा सकने वाले पैरामीटर और उनकी संभावित वैल्यू यहां दी गई हैं.
ज़रूरी पैरामीटर
ऐसे में, आप या तो:
location, टेक्स्ट स्ट्रिंग (जैसे किChagrin Falls, OH) या अक्षांश और देशांतर के निर्देशांकों का जोड़ा (40.457375,-80.009353) हो सकता है. साथ ही, इसे यूआरएल-कोड में बदला गया होना चाहिए. इसलिए, अनुरोध भेजने से पहले "City Hall, New York, NY" जैसे पतों को "City+Hall,New+York,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 Plan के पुराने ग्राहकों के लिए, डिजिटल हस्ताक्षर करना ज़रूरी है. प्रीमियम प्लान के खरीदारों के लिए पुष्टि करने वाले पैरामीटर के बारे में ज़्यादा जानें.
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 NOT FOUND) या अमान्य अनुरोध (400 BAD REQUEST) के जवाब में, एपीआई को गड़बड़ी कोड दिखाना चाहिए या नहीं. मान्य वैल्यू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 Static API एक ग्रे रंग की सामान्य इमेज दिखाता है. इस इमेज में "माफ़ करें, हमारे पास यहां की कोई इमेज नहीं है" टेक्स्ट लिखा होता है. इस उदाहरण में दिखाया गया है कि यह इमेज कैसी दिखती है:
सिर्फ़ मान्य इमेज दिखाएं
सामान्य इमेज दिखाने से बचने और यह पक्का करने के लिए कि आपके वेब पेज पर सिर्फ़ Street View Static API की मान्य इमेज दिखें, इन सुझावों का पालन करें:
return_error_codeपैरामीटर कोtrueपर सेट करें. अगर दी गई जगह के लिए कोई इमेज उपलब्ध नहीं है, तो Street View Static API, सामान्य ग्रे इमेज के बजाय 404 NOT FOUND गड़बड़ी दिखाता है.- अनुरोध भेजने से पहले, स्ट्रीट व्यू इमेज मेटाडेटा का अनुरोध करें. इससे यह पता चलेगा कि दी गई जगह के लिए इमेज उपलब्ध है या नहीं.