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