Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Streetview अनुरोध और जवाब

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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