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 स्टैटिक एपीआई, जगह के सबसे पास मौजूद पैनोरामा फ़ोटो लेता है. जब पते की टेक्स्ट स्ट्रिंग दी जाती है, तो एपीआई बताई गई जगह की जानकारी को बेहतर तरीके से दिखाने के लिए कैमरे की अलग जगह का इस्तेमाल कर सकता है. अक्षांश और देशांतर निर्देशांक की जानकारी देने पर, एपीआई जगह के सबसे करीब मौजूद फ़ोटोग्राफ़ के लिए, 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
वैल्यू दी जा सकती है. तय साइज़ वाले व्यूपोर्ट का इस्तेमाल करते समय, तय साइज़ के Street View में दिखने वाली इमेज के फ़ील्ड में, ज़ूम को दिखाने वाला फ़ील्ड होता है. इसमें कम संख्या दिखाकर, ज़ूम के ज़्यादा लेवल का पता चलता है.
(बाएं: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
, खोज के नतीजों को आउटडोर कलेक्शन तक सीमित रखता है. खोज के नतीजों में इनडोर कलेक्शन शामिल नहीं होते. ध्यान दें, हो सकता है कि बताई गई जगह के लिए आउटडोर पैनोरामा मौजूद न हों. यह भी ध्यान रखें कि खोज करने पर सिर्फ़ पैनोरामा दिखते हैं, ताकि यह पता लगाया जा सके कि वे घर के अंदर हैं या बाहर. उदाहरण के लिए, 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 View स्टैटिक एपीआई, सामान्य स्लेटी रंग की इमेज की जगह 404 NOT FOUND की गड़बड़ी दिखाता है.- अनुरोध भेजने से पहले यह तय करने के लिए Street View इमेज मेटाडेटा का अनुरोध करें कि किसी खास जगह के लिए तस्वीरें उपलब्ध हैं या नहीं.