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

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

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

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

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

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

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

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


    बहुत बड़े इलाके के व्यू का स्क्रीनशॉट, जिसमें अक्वेरियम के अंदर की छत, दीवारें, फ़र्श, और टैंक विंडो दिख रही है. क्लोज़-अप शॉट फ़ील्ड ऑफ़ व्यू का स्क्रीनशॉट, जिसमें अक्वेरियम के अंदर Street View की फ़ोटो की ज़ूम-इन की गई जानकारी दिख रही है.
    (बाएं: 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 स्टैटिक एपीआई इमेज दिखाता है, इनका पालन करें सुझाव:

  • return_error_code पैरामीटर को true पर सेट करें. इसकी वजह से Street Viewstatic API, 404 NOT FOUND कोड दिखाता है सामान्य स्लेटी इमेज की जगह पर गड़बड़ी दिखेगी, अगर इसके लिए कोई इमेज उपलब्ध नहीं है बताई गई जगह.
  • 'स्ट्रीट व्यू' की इमेज के मेटाडेटा का अनुरोध करें ताकि यह पता लगाया जा सके कि बताई गई जगह की तस्वीरें उपलब्ध हैं या नहीं कोई अनुरोध भेजने के लिए.