परिचय
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 या कोई वैल्यू नहीं मिलती है, तो इसका मतलब है कि पैनोरामा आईडी मिटा दिया गया है और उसे रीफ़्रेश करना होगा.
पैनोरामा आईडी पाने के लिए इस्तेमाल किए गए जगह के पते या अक्षांश और देशांतर के निर्देशांकों को सेव करें, ताकि ज़रूरत पड़ने पर उन्हें रीफ़्रेश किया जा सके.
जब आपको पता चले कि पैनोरामा आईडी बदल गया है, तो उस जगह के सबसे नज़दीकी पैनोरामा को फिर से खोजने और नया पैनोरामा आईडी पाने के लिए, मूल जगह के पते या अक्षांश और देशांतर के निर्देशांकों का इस्तेमाल करें.
मेटाडेटा के अनुरोधों के लिए वैकल्पिक पैरामीटर
मेटाडेटा के अनुरोध में ये पैरामीटर शामिल किए जा सकते हैं: size, heading, fov, और pitch. ध्यान दें कि इन पैरामीटर से पैनोरामा के डेटा या पैनोरामा के खोजे जाने पर कोई असर नहीं पड़ता.
एपीआई में, इमेजरी के अनुरोध की तरह ही पैरामीटर शामिल किए जा सकते हैं. इससे, इमेजरी के किसी खास अनुरोध से जुड़े मेटाडेटा का अनुरोध करना आसान हो जाता है. हालांकि, मेटाडेटा के अनुरोधों के लिए, एपीआई वैकल्पिक पैरामीटर और उनकी वैल्यू को अनदेखा कर देता है. इन पैरामीटर का इस्तेमाल करने के बारे में जानकारी पाने के लिए, Street View Static API डेवलपर की गाइड देखें.
जवाब का फ़ॉर्मैट
मेटाडेटा के जवाब सिर्फ़ JSON फ़ॉर्मैट में दिखाए जाते हैं.
उदाहरण
उदाहरण 1: पैनोरामा मिला
यहां दिए गए यूआरएल, एक ही पैनोरामा के मेटाडेटा और इमेज का अनुरोध करते हैं.
मेटाडेटा का अनुरोध और जवाब
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
स्टेटस कोड
मेटाडेटा रिस्पॉन्स ऑब्जेक्ट में मौजूद 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 का सहायता पेज देखें.