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