Street View की इमेज का मेटाडेटा

परिचय

Street View Static API के मेटाडेटा के अनुरोधों से, Street View के पैनोरामा के बारे में डेटा मिलता है. मेटाडेटा का इस्तेमाल करके, यह पता लगाया जा सकता है कि किसी जगह पर Street View की इमेज उपलब्ध है या नहीं. इसके अलावा, प्रोग्राम के ज़रिए अक्षांश और देशांतर के निर्देशांक, पैनोरामा आईडी, फ़ोटो लिए जाने की तारीख, और इमेज के कॉपीराइट की जानकारी भी पाई जा सकती है. इस मेटाडेटा को ऐक्सेस करके, अपने ऐप्लिकेशन में गड़बड़ी होने पर दिखने वाले मैसेज को पसंद के मुताबिक बनाया जा सकता है.

Street View Static API के मेटाडेटा के अनुरोधों के लिए कोई शुल्क नहीं लिया जाता. मेटाडेटा का अनुरोध करने पर, कोटा का इस्तेमाल नहीं होता. कोटा का इस्तेमाल तब ही होता है, जब आप Street View Static API का इस्तेमाल करके कोई इमेज लोड करते हैं.

Street View की इमेज के मेटाडेटा के अनुरोध करने पर, पैनोरामा की इमेज 50 मीटर तक सटीक होती है.

इमेज के मेटाडेटा को ऐक्सेस करना

Street View की इमेज के मेटाडेटा का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है.

मेटाडेटा के अनुरोधों के लिए ज़रूरी पैरामीटर

मेटाडेटा के अनुरोधों में, Street View Static API की इमेज के अनुरोधों के लिए इस्तेमाल किए जाने वाले यूआरएल पैरामीटर ही इस्तेमाल किए जाते हैं. हालांकि, सिर्फ़ ये पैरामीटर ज़रूरी हैं:

ऐसे में, आप या तो:

  • location — यह टेक्स्ट स्ट्रिंग (जैसे, Chagrin Falls, OH) या अक्षांश और देशांतर के निर्देशांकों का कॉमा से अलग किया गया जोड़ा (40.457375,-80.009353) हो सकता है.

या:

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

इसके अलावा:

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

सिर्फ़ ज़रूरी पैरामीटर के साथ, आपका मेटाडेटा अनुरोध ऐसा दिखता है:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

या ऐसा:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

मिटाए गए पैनोरामा आईडी रीफ़्रेश करना

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

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

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

मेटाडेटा के अनुरोधों के लिए वैकल्पिक पैरामीटर

मेटाडेटा के अनुरोध में, ये पैरामीटर शामिल किए जा सकते हैं: size, heading, fov, और pitch. ध्यान दें कि इन पैरामीटर से, पैनोरामा के बारे में डेटा या यह तय नहीं होता कि कौनसे पैनोरामा दिखेंगे. एपीआई, इमेज के अनुरोध के लिए इस्तेमाल किए जाने वाले पैरामीटर को शामिल करने की अनुमति देता है. इससे, इमेज के किसी खास अनुरोध से जुड़ा मेटाडेटा अनुरोध बनाना आसान हो जाता है. हालांकि, मेटाडेटा के अनुरोधों के लिए, एपीआई वैकल्पिक पैरामीटर और उनकी वैल्यू को नज़रअंदाज़ करता है. इन पैरामीटर का इस्तेमाल करने के बारे में जानकारी पाने के लिए, Street View Static API की डेवलपर गाइड देखें.

जवाब का फ़ॉर्मैट

मेटाडेटा के जवाब सिर्फ़ JSON फ़ॉर्मैट में दिखाए जाते हैं.

उदाहरण

पहला उदाहरण: पैनोरामा मिला

यहां दिए गए यूआरएल, एक ही पैनोरामा के मेटाडेटा और इमेज का अनुरोध करते हैं.

मेटाडेटा का अनुरोध और जवाब

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
 
{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

इमेज का अनुरोध और जवाब. इसमें, इमेज के न मिलने की उम्मीद है.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
एफ़िल टावर

दूसरा उदाहरण: पैनोरामा नहीं मिला

यहां दिए गए यूआरएल, किसी ऐसी जगह के मेटाडेटा और इमेज का अनुरोध करते हैं जहां पैनोरामा नहीं मिला.

मेटाडेटा का अनुरोध और जवाब

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
 
{
   "status" : "ZERO_RESULTS"
}

इमेज का अनुरोध और जवाब

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
No Imagery Here Placeholder

स्टेटस कोड

मेटाडेटा के जवाब वाले ऑब्जेक्ट में मौजूद status फ़ील्ड में, अनुरोध की स्थिति दिखती है. इसमें डीबग करने की जानकारी भी शामिल हो सकती है. इससे यह पता लगाने में मदद मिलती है कि Street View का अनुरोध क्यों काम नहीं कर रहा है. status फ़ील्ड में ये वैल्यू हो सकती हैं:

स्टेटस ब्यौरा
"OK" इसका मतलब है कि कोई गड़बड़ी नहीं हुई. साथ ही, पैनोरामा मिल गया है और मेटाडेटा दिखाया जा रहा है.
"ZERO_RESULTS" इसका मतलब है कि दी गई जगह के आस-पास कोई पैनोरामा नहीं मिला. यह जवाब तब मिल सकता है, जब आपने ऐसा पैनोरामा आईडी दिया हो जो मौजूद नहीं है या अमान्य है. [मिटाए गए पैनोरामा आईडी रीफ़्रेश करना](#refresh-pano) लेख पढ़ें.
"NOT_FOUND" इसका मतलब है कि location पैरामीटर में दिया गया पता नहीं मिला. यह मैसेज तब दिख सकता है, जब कोई ऐसा पता दिया गया हो जो मौजूद नहीं है.
"OVER_QUERY_LIMIT" इसका मतलब है कि आपने इस एपीआई के लिए, हर दिन या हर सेकंड के लिए तय कोटा पार कर लिया है.
"REQUEST_DENIED" इसका मतलब है कि आपका अनुरोध नामंजूर कर दिया गया है. यह मैसेज तब दिख सकता है, जब आपने अपने अनुरोध को अनुमति न दी हो या Google Cloud console के उस प्रोजेक्ट में Street View Static API चालू न हो जिसमें आपका एपीआई पासकोड मौजूद है.
"INVALID_REQUEST" आम तौर पर, इसका मतलब है कि क्वेरी पैरामीटर (पता, अक्षांश और देशांतर के निर्देशांक या कॉम्पोनेंट) मौजूद नहीं हैं.
"UNKNOWN_ERROR" इसका मतलब है कि सर्वर में गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. यह समस्या अक्सर कुछ समय के लिए होती है. दोबारा कोशिश करने पर, हो सकता है कि अनुरोध पूरा हो जाए.

ज़्यादा जानकारी

Street View Static API या Google Maps API के अन्य प्रॉडक्ट इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Maps API सहायता वाला पेज देखें.