परिचय
Street View स्टैटिक एपीआई मेटाडेटा के अनुरोध, Street के बारे में डेटा उपलब्ध कराते हैं पैनोरामा देखें. मेटाडेटा का इस्तेमाल करके, यह पता लगाया जा सकता है कि Street View की कोई इमेज कोई जगह उपलब्ध नहीं होती है. साथ ही, आपको अपने-आप होने वाली प्रोसेस का ऐक्सेस मिलता है अक्षांश और देशांतर निर्देशांक, पैनोरामा आईडी, फ़ोटो लेने की तारीख लिया गया है और इमेज के कॉपीराइट की जानकारी शामिल है. इसे ऐक्सेस करना मेटाडेटा की मदद से आप अपने ऐप्लिकेशन में गड़बड़ी के व्यवहार को पसंद के मुताबिक बना सकते हैं.
Street View स्टैटिक एपीआई मेटाडेटा के अनुरोध यहां उपलब्ध नहीं हैं चार्ज. मेटाडेटा का अनुरोध करने पर, कोई कोटा खर्च नहीं होता. कोटा सिर्फ़ तब इस्तेमाल होता है, जब Street View स्टैटिक एपीआई.
Street View की तस्वीरों के मेटाडेटा के अनुरोध करते समय, पैनोरामा की तस्वीरें 50 मीटर तक सटीक होता है.
तस्वीरों के संग्रह का मेटाडेटा ऐक्सेस करना
Street View की इमेज के मेटाडेटा के लिए अनुरोध, इस फ़ॉर्म का एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
यूआरएल के स्टैंडर्ड की तरह ही, सभी पैरामीटर को ऐंपरसेंड का इस्तेमाल करके अलग किया जाता है (&) वर्ण.
मेटाडेटा के अनुरोधों के लिए ज़रूरी पैरामीटर
मेटाडेटा अनुरोध एक जैसे यूआरएल पैरामीटर के रूप में दिखाया गया है, हालांकि ये पैरामीटर ज़रूरी हैं:
ऐसे में, आप या तो:
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" |
इससे पता चलता है कि आपका अनुरोध अस्वीकार कर दिया गया है. यह मैसेज दिख सकता है, अगर आपने आपने अनुरोध की अनुमति नहीं दी है या Street View स्टैटिक एपीआई चालू नहीं है, Google Cloud Console प्रोजेक्ट, जिसमें आपका एपीआई पासकोड शामिल है. |
"INVALID_REQUEST" |
आम तौर पर यह बताता है कि क्वेरी पैरामीटर (पता, अक्षांश और देशांतर निर्देशांक या कॉम्पोनेंट) मौजूद नहीं हैं. |
"UNKNOWN_ERROR" |
इससे पता चलता है कि सर्वर की गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. आम तौर पर, यह समस्या कुछ समय के लिए होती है. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है. |
ज़्यादा जानकारी
Street View स्टैटिक एपीआई का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, या अन्य Google Maps API प्रॉडक्ट के लिए, Maps API ज़रूर देखें सहायता पेज.