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