Street View की इमेज का मेटाडेटा

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

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

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

या इस तरह:

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

मिटाए गए पैनोरामा आईडी रीफ़्रेश करें

अगर आप पैनोरामा आईडी फिर से पाने की कोशिश करते हैं और आपको ZERO_RESULTS या कोई वैल्यू नहीं मिलती, तो इसका मतलब है कि पैनोरामा आईडी मिटा दिया गया है और आपको इसे रीफ़्रेश करना होगा.

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

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

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

आपके पास मेटाडेटा के अनुरोध में ये पैरामीटर शामिल करने का विकल्प होता है: 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 सहायता पेज देखना न भूलें.