'स्ट्रीट व्यू' इमेज का मेटाडेटा

शुरुआती जानकारी

Street View स्टैटिक एपीआई के मेटाडेटा के अनुरोध, Street View पैनोरामा के बारे में डेटा देते हैं. मेटाडेटा की मदद से यह पता लगाया जा सकता है कि किसी स्ट्रीट व्यू इमेज किसी खास जगह पर मौजूद है या नहीं. साथ ही, अक्षांश और देशांतर, पैनोरामा आईडी, फ़ोटो लेने की तारीख, और इमेज के लिए कॉपीराइट की जानकारी का प्रोग्रैम्ड तरीके से भी पता लगाया जा सकता है. इस मेटाडेटा को ऐक्सेस करके, अपने ऐप्लिकेशन में गड़बड़ियों को पसंद के मुताबिक बनाया जा सकता है.

Street View स्टैटिक एपीआई के मेटाडेटा के अनुरोध बिना किसी शुल्क के उपलब्ध हैं. मेटाडेटा के लिए अनुरोध करने पर, कोटे की खपत नहीं होती. कोटे का इस्तेमाल सिर्फ़ तब किया जाता है, जब Street View स्टैटिक एपीआई का इस्तेमाल करके कोई इमेज लोड की जाती है.

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=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

या इस तरह:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

मेटाडेटा के अनुरोधों के लिए वैकल्पिक पैरामीटर

मेटाडेटा के अनुरोध में ये पैरामीटर शामिल किए जा सकते हैं: size, heading, fov, और pitch. ध्यान दें कि ये पैरामीटर, पैनोरामा के डेटा या मिलने वाले पैनोरामा पर कोई असर नहीं डालते. एपीआई, तस्वीरों के अनुरोध जैसे पैरामीटर शामिल करने की अनुमति देता है. इससे किसी खास इमेज के अनुरोध से जुड़े मेटाडेटा के अनुरोध को बनाने में आसानी होती है. हालांकि, मेटाडेटा के अनुरोधों के लिए एपीआई, वैकल्पिक पैरामीटर और उनकी वैल्यू को अनदेखा कर देता है. इन पैरामीटर को इस्तेमाल करने के बारे में जानकारी के लिए, Street View स्टैटिक एपीआई डेवलपर की गाइड देखें.

जवाब का फ़ॉर्मैट

मेटाडेटा से जुड़े जवाब सिर्फ़ 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" इससे पता चलता है कि दी गई जगह के आस-पास कोई पैनोरामा नहीं मिला. ऐसा तब हो सकता है, जब किसी ऐसे पैनोरामा आईडी का इस्तेमाल किया गया हो जो मौजूद नहीं है या अमान्य है.
"NOT_FOUND" इससे पता चलता है कि location पैरामीटर में दी गई पता स्ट्रिंग नहीं मिली. ऐसा तब हो सकता है, जब कोई गैर-मौजूद पता दिया गया हो.
"OVER_QUERY_LIMIT" इससे पता चलता है कि आपने इस एपीआई के लिए, हर दिन या हर सेकंड की तय सीमा को पार कर लिया है.
"REQUEST_DENIED" इससे पता चलता है कि आपका अनुरोध अस्वीकार कर दिया गया था. ऐसा तब हो सकता है, जब आपने अनुरोध की अनुमति न दी हो या आपके एपीआई पासकोड वाले Google Cloud Console प्रोजेक्ट में Street View स्टैटिक एपीआई चालू न हो.
"INVALID_REQUEST" आम तौर पर, यह बताता है कि क्वेरी पैरामीटर (पता या latlng या कॉम्पोनेंट) मौजूद नहीं हैं.
"UNKNOWN_ERROR" इससे पता चलता है कि सर्वर की गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. यह स्थिति अक्सर कुछ समय के लिए होती है. अगर आप फिर से कोशिश करते हैं, तो हो सकता है कि अनुरोध पूरा हो जाए.

ज़्यादा जानकारी

Street View स्टैटिक एपीआई या Google Maps API के अन्य प्रॉडक्ट इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, Maps API का सहायता पेज देखना न भूलें.