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

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

Street View स्टैटिक एपीआई मेटाडेटा के अनुरोध, 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=&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 के स्टैटिक एपीआई डेवलपर की गाइड देखें.

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

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

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

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