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 या कोई वैल्यू नहीं मिलती है, तो इसका मतलब है कि पैनोरमा आईडी मिटा दिया गया है. इसलिए, इसे रीफ़्रेश करना होगा.

  1. जगह का पता या अक्षांश और देशांतर के निर्देशांक सेव करें. इनका इस्तेमाल आपने पैनोरमा आईडी पाने के लिए किया था, ताकि ज़रूरत पड़ने पर इन्हें रीफ़्रेश किया जा सके.

  2. जब आपको पता चले कि पैनोरमा आईडी बदल गया है, तो उस जगह के सबसे नज़दीकी पैनोरमा को फिर से खोजने के लिए, जगह के मूल पते या अक्षांश और देशांतर के निर्देशांकों का इस्तेमाल करें. इसके बाद, नया पैनोरमा आईडी पाएं.

ज़रूरी नहीं पैरामीटर

  • signature (सुझाया गया) एक डिजिटल हस्ताक्षर है. इसका इस्तेमाल यह पुष्टि करने के लिए किया जाता है कि आपकी एपीआई पासकोड का इस्तेमाल करके अनुरोध जनरेट करने वाली किसी भी साइट को ऐसा करने की अनुमति है. डिजिटल हस्ताक्षर शामिल न करने वाले अनुरोध पूरे नहीं किए जा सकते. ज़्यादा जानकारी के लिए, कुंजी और हस्ताक्षर पाना लेख पढ़ें.

    ध्यान दें: Google Maps Platform Premium Plan के मौजूदा ग्राहकों के लिए, डिजिटल हस्ताक्षर ज़रूरी है. प्रीमियम प्लान के खरीदारों के लिए पुष्टि करने वाले पैरामीटर के बारे में ज़्यादा जानें.

  • heading से कैमरे की कंपास हेडिंग का पता चलता है. इस्तेमाल की जा सकने वाली वैल्यू 0 से 360 तक होती हैं. और , दोनों का मतलब उत्तर होता है. 90 का मतलब पूरब और 180 का मतलब दक्षिण होता है. अगर आपने कोई हेडिंग नहीं दी है, तो एक वैल्यू कैलकुलेट की जाती है. इससे कैमरे को उस पॉइंट से, तय किए गए location की ओर घुमाया जाता है जहां से सबसे नज़दीकी फ़ोटो ली गई थी.
  • fov (डिफ़ॉल्ट वैल्यू 90 है) यह इमेज के हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू को डिग्री में दिखाता है. इसकी ज़्यादा से ज़्यादा वैल्यू 120 हो सकती है. जब किसी तय साइज़ वाले व्यूपोर्ट का इस्तेमाल किया जाता है, तब फ़ील्ड ऑफ़ व्यू का मतलब ज़ूम होता है. जैसे, किसी तय साइज़ की Street View इमेज में, छोटी संख्याएं ज़्यादा ज़ूम लेवल दिखाती हैं.


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

यह अनुरोध का एक उदाहरण है.

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