परिचय
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=
या इस तरह से:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&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 ज़रूर देखें सहायता पेज.