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