सुविधा के बारे में जानकारी
स्ट्रीट व्यू स्टैटिक एपीआई मेटाडेटा के अनुरोध से, Street View के पैनोरामा का डेटा मिलता है. मेटाडेटा का इस्तेमाल करके, आप पता लगा सकते हैं कि स्ट्रीट व्यू की इमेज किसी खास जगह पर उपलब्ध है या नहीं. साथ ही, आप अक्षांश और देशांतर, पैनोरामा आईडी, फ़ोटो क्लिक करने की तारीख, और इमेज की कॉपीराइट जानकारी का प्रोग्रामैटिक ऐक्सेस भी पा सकते हैं. इस मेटाडेटा को ऐक्सेस करने से, ऐप्लिकेशन में गड़बड़ी के व्यवहार को अपने हिसाब से बनाया जा सकता है.
Street View स्टैटिक एपीआई के मेटाडेटा के अनुरोध, बिना किसी शुल्क के उपलब्ध हैं. मेटाडेटा का अनुरोध करने पर, कोई कोटा इस्तेमाल नहीं किया जाता है. कोटा सिर्फ़ तब इस्तेमाल होता है, जब आप Street View स्टैटिक एपीआई का इस्तेमाल करके कोई इमेज लोड करते हैं.
Street View की तस्वीरों का मेटाडेटा बनाने के अनुरोध करते समय, पैनोरामा की तस्वीरें 50 मीटर तक सटीक होती हैं.
इमेजरी मेटाडेटा तक पहुंचना
'स्ट्रीट व्यू' इमेज मेटाडेटा के लिए अनुरोध, इस फ़ॉर्म का एचटीटीपी यूआरएल है:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
जैसा कि URL में मानक है, सभी पैरामीटर एंपरसैंड (&) वर्ण का उपयोग करके अलग किए जाते हैं.
मेटाडेटा अनुरोधों के लिए ज़रूरी पैरामीटर
मेटाडेटा अनुरोध उसी तरह यूआरएल पैरामीटर को स्वीकार करते हैं, जैसे कि Street View Static API की तस्वीरों का अनुरोध, हालांकि सिर्फ़ नीचे दिए गए पैरामीटर ज़रूरी होते हैं:
ऐसे में, आप या तो:
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
. ध्यान दें कि इन
पैरामीटर से पैनोरामा के डेटा या किसी पैनोरामा के मिलने पर कोई असर नहीं पड़ता है.
एपीआई उन तस्वीरों को शामिल करता है जिन्हें इमेजरी अनुरोध के तौर पर इस्तेमाल किया जाता है. इससे किसी खास इमेजरी अनुरोध से जुड़ा मेटाडेटा बनाने में आसानी होती है. हालांकि, मेटाडेटा अनुरोधों के लिए एपीआई, वैकल्पिक पैरामीटर और उनकी वैल्यू को अनदेखा कर देता है.
इन पैरामीटर का इस्तेमाल करने के बारे में जानकारी के लिए 'स्ट्रीट व्यू' के स्टैटिक एपीआई की डेवलपर गाइड देखें.
रिस्पॉन्स फ़ॉर्मैट
मेटाडेटा से जुड़े रिस्पॉन्स, सिर्फ़ 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
फ़ील्ड में अनुरोध की स्थिति होती है. साथ ही, इसमें डीबग की जानकारी शामिल हो सकती है, जिससे आपको यह समझने में मदद मिलेगी कि स्ट्रीट व्यू अनुरोध क्यों काम नहीं कर रहा है. status
फ़ील्ड में ये वैल्यू हो सकती हैं:
स्थिति | जानकारी |
---|---|
"OK" |
इससे पता चलता है कि कोई गड़बड़ी नहीं हुई है. पैनोरामा मिल जाता है और मेटाडेटा दिखता है. |
"ZERO_RESULTS" |
यह बताता है कि दी गई जगह के आस-पास कोई पैनोरामा नहीं मिला. ऐसा तब हो सकता है, जब पैनोरामा आईडी मौजूद न हो या मौजूद न हो. |
"NOT_FOUND" |
यह बताता है कि location पैरामीटर में दी गई पता स्ट्रिंग नहीं मिली. ऐसा तब हो सकता है, जब कोई पता मौजूद न हो. |
"OVER_QUERY_LIMIT" |
इससे पता चलता है कि आपने इस एपीआई के लिए, अपने हर दिन की तय सीमा या हर सेकंड के कोटे की सीमा पार कर ली है. |
"REQUEST_DENIED" |
इससे पता चलता है कि आपका अनुरोध अस्वीकार कर दिया गया था. ऐसा तब हो सकता है, जब आपने अनुरोध को अनुमति न दी हो या Google Cloud Console के प्रोजेक्ट में Street View स्टैटिक एपीआई चालू न हो. इसमें आपकी एपीआई कुंजी भी शामिल है. |
"INVALID_REQUEST" |
आम तौर पर यह बताता है कि क्वेरी पैरामीटर (पता या अक्षांश या कॉम्पोनेंट) मौजूद नहीं हैं. |
"UNKNOWN_ERROR" |
यह बताता है कि सर्वर में हुई किसी गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. आम तौर पर, यह एक अस्थायी स्थिति होती है. आपके दोबारा कोशिश करने पर, अनुरोध पूरा हो सकता है. |
ज़्यादा जानकारी
Street View स्टैटिक एपीआई या Google Maps के दूसरे प्रॉडक्ट का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Maps API का सहायता पेज देखना न भूलें.