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