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तक होती हैं.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 गड़बड़ी दिखाता है.- अनुरोध भेजने से पहले, स्ट्रीट व्यू इमेज के मेटाडेटा का अनुरोध करें. इससे यह पता चलेगा कि दी गई जगह के लिए इमेज उपलब्ध हैं या नहीं.