इस पेज का अनुवाद Cloud Translation API से किया गया है.

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 या कोई वैल्यू नहीं मिलती है, तो इसका मतलब है कि पैनोरमा आईडी मिटा दिया गया है. इसलिए, आपको इसे रीफ़्रेश करना होगा.

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

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

मेटाडेटा के अनुरोध में, ये पैरामीटर शामिल किए जा सकते हैं: 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

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

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

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

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 का सहायता पेज देखें.