Street View टाइल, 2D टाइल की तरह ही होती हैं. हालांकि, इनमें स्ट्रीट लेवल से ली गई खूबसूरत तस्वीरें होती हैं. Street View की मदद से, दुनिया की मशहूर जगहों को एक्सप्लोर किया जा सकता है और प्राकृतिक अजूबे देखे जा सकते हैं. साथ ही, म्यूज़ियम, अरीना, रेस्टोरेंट या छोटे कारोबारों जैसी जगहों को अंदर से देखा जा सकता है. इस एपीआई एंडपॉइंट से आपको इनका ऐक्सेस मिलता है:
- Google Maps Street View टाइल
- Street View का मेटाडेटा
- Street View के थंबनेल
असल ज़िंदगी में पैनोरामा इफ़ेक्ट बनाने के लिए, आप सड़क के स्तर से ली गई इमेज टाइल को एक साथ जोड़ सकते हैं. साथ ही, जगहों (जैसे कि किसी रास्ते) के एक सेट के लिए, ज़्यादा से ज़्यादा 100 पैनोरामा आईडी तक क्वेरी की जा सकती है. साथ ही, कैमरे की स्थिति के बारे में ज़्यादा जानकारी वाला मेटाडेटा भी पाया जा सकता है.
दर्शक को Street View टाइल को एक साथ जोड़ना होगा. उदाहरण के लिए, स्ट्रीट व्यू पसंद के मुताबिक पैनोरामा व्यूअर.
एपीआई पासकोड हासिल करने के बाद, यह तरीका अपनाकर Street View की तस्वीरें ऐक्सेस करें.
सेशन टोकन पाएं.
mapType
की वैल्यू कोstreetview
पर सेट करना न भूलें.एक या ज़्यादा भौगोलिक जगहों का पैनोरामा आइडेंटिफ़ायर (panoId) पाने के लिए, सेशन टोकन का इस्तेमाल करें.
यह पाने के लिए panoId खोज जवाब से पैनोरामा आइडेंटिफ़ायर का इस्तेमाल करें:
Street View मेटाडेटा. निर्देशांकों का एक सेट और दायरा पार करके भी, Street View का मेटाडेटा मिल सकता है.
Street View के तरीके
Street View की तस्वीरें और मेटाडेटा को ऐक्सेस करने के लिए, यहां दिए गए चार तरीकों में से किसी एक का इस्तेमाल करें.
तरीका | ब्यौरा |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
अलग-अलग Street View टाइल दिखाता है. Street View Tiles को छह ज़ूम लेवल पर वापस लाया जा सकता है: 512 पिक्सल से लेकर 13,312 पिक्सल तक. |
https://tile.googleapis.com/v1/streetview/panoIds |
आपको एक साथ ज़्यादा से ज़्यादा 100 जगहों की जानकारी खोजने की सुविधा मिलती है. तस्वीरों के संग्रह वाली सभी जगहों के पैनोरामा आईडी दिखाता है. |
https://tile.googleapis.com/v1/streetview/thumbnail |
Street View सीन का थंबनेल JPEG इमेज दिखाता है. इसकी मदद से हेडिंग, पिच, डाइमेंशन, और फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) की जानकारी दी जा सकती है. डाइमेंशन कम से कम 16x16 पिक्सल का होना चाहिए. डाइमेंशन ज़्यादा से ज़्यादा 250x600 पिक्सल तक होने चाहिए. |
https://tile.googleapis.com/v1/streetview/metadata |
बताए गए पैनोरामा के बारे में ज़्यादा जानकारी देता है. विवरण में संबंधित पता और आस-पास के पैनोरामा के लिंक शामिल हैं. |
स्ट्रीट व्यू पैनोआईडी खोज
आप भौगोलिक जगहों के निर्देशांक (lat
, lng
) को panoIds
तरीके में पास करके, एक या उससे ज़्यादा जगहों के पैनोरामा आइडेंटिफ़ायर ढूंढ सकते हैं. अनुरोध का मुख्य हिस्सा, एक JSON ऑब्जेक्ट है. इसमें locations
कलेक्शन होता है. साथ ही, इसमें radius
का कलेक्शन भी होता है, जैसा कि JSON कोड के इस उदाहरण में दिखाया गया है.
curl -X POST -d '{ "locations": [ {"lat": -33.883837, "lng": 151.209307}, {"lat": -33.883700, "lng": 151.210307}, {"lat": 0, "lng": 0} ], "radius": 50 }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY"
locations
locations
कैटगरी में कोऑर्डिनेट वैल्यू का कम से कम एक सेट होना चाहिए. हालांकि, ज़्यादा से ज़्यादा 100 वैल्यू को शामिल किया जा सकता है.radius
radius
वैल्यू (मीटर में मापी जाती है) दी गई जगह के आस-पास सर्कल का दायरा तय करती है, जिसमें पैनोरामा खोजना चाहते हैं. डिफ़ॉल्ट वैल्यू 50 मीटर है.
PanoId से मिला जवाब
Map Tiles API, हर जगह के सबसे पास के पैनोरामा को ढूंढने की कोशिश करता है और
फिर उनके पैनोरामा आईडी दिखाता है. panoIds
अनुरोध पूरा होने पर,
JSON ऑब्जेक्ट दिखता है जिसमें panoIds
कलेक्शन होता है. अरे में पैनोरामा आईडी की सूची होती है. यह सूची उसी क्रम में होती है जिस क्रम में आपने उनका अनुरोध किया है. अगर Map Tiles API को आपकी अनुरोध की गई जगहों के लिए कोई पैनोरामा नहीं मिलता, तो उस जगह पर अरे में एक खाली स्ट्रिंग दिखती है. उदाहरण के लिए, यहां दिया गया JSON कोड देखें.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
panoIds
का इस्तेमाल इन कामों के लिए किया जा सकता है:
- Street View मेटाडेटा के लिए अनुरोध करना
- Street View के लिए थंबनेल के लिए अनुरोध करना
- Street View टाइल के लिए अनुरोध करना
Street View का मेटाडेटा
Street View मेटाडेटा के अनुरोध, पैनोरामा के बारे में जानकारी हासिल करते हैं. Street View के मेटाडेटा के लिए किया गया अनुरोध, एचटीटीपीएस जीईटी अनुरोध होता है. आप इनमें से किसी एक तरीके से पैनोरामा के बारे में जानकारी हासिल कर सकते हैं:
pano_id
को पास करने पर, Map Tiles API उस पैनोरामा का मेटाडेटा दिखाता है.हालांकि,
lat
औरlng
को पास करने पर, Map Tiles API दिए गए खोज के दायरे में, सबसे नज़दीकी पैनोरामा के लिए मेटाडेटा दिखाता है.
निर्देशांकों का एक समुच्चय और एक त्रिज्या पास करें
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
पैनोरामा आईडी, कुछ समय के लिए होते हैं. इसलिए, हमारा सुझाव है कि आप अपने शुरुआती Street View मेटाडेटा अनुरोध में निर्देशांक का एक सेट और radius
वैल्यू पास करें.
उदाहरण के लिए, यह कोड स्निपेट देखें.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
Street View की किसी इमेज का पैनोआईडी पास करें
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
मेटाडेटा से मिला रिस्पॉन्स
यहां दिया गया JSON कोड, सामान्य मेटाडेटा के रिस्पॉन्स का उदाहरण है.
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
इस सूची में, रिस्पॉन्स के मुख्य हिस्से में मौजूद फ़ील्ड की परिभाषाएं दी गई हैं.
panoId
- इस पैनोरामा का यूनीक आईडी. आपको पैनोरामा आईडी पर एक उपयोगकर्ता सेशन से ज़्यादा समय के लिए मान्य होने पर भरोसा नहीं करना चाहिए.
lat
,lng
- पैनोरामा के निर्देशांक (अक्षांश और देशांतर). ये वैल्यू, अनुरोध में पास किए गए कोऑर्डिनेट से अलग हो सकती हैं, क्योंकि जगह सबसे नज़दीकी पैनोरामा में स्नैप हो जाती है.
imageHeight
,imageWidth
- स्टिच की गई पैनोरामा इमेज के डाइमेंशन.
tileHeight
,tileWidth
- एक पैनोरामा टाइल के डाइमेंशन.
heading
- कंपास का हेडिंग, उत्तर से घड़ी की सुई की दिशा में डिग्री में मापा गया. टाइटल को [0,360] की रेंज में दिखाया जाता है, जिसमें 0 जवाब उत्तर के तौर पर दिखता है.
tilt
- पैनोरामा का झुकाव, जिसे पैनोरामा के दक्षिणी ध्रुव से लेकर क्षितिज तक डिग्री में मापा गया है. दी गई वैल्यू, [0, 180] की रेंज के अंदर हैं. 90 डिग्री का मान यह बताता है कि क्षितिज पहले से ही पैनोरामा की भूमध्य रेखा पर अलाइन है.
roll
- क्षितिज को देखने के लिए घड़ी की सुई की दिशा में घुमाना, जिसे पैनोरामा पर लागू किया गया था. दी गई वैल्यू, [0, 360] की रेंज के अंदर हैं.
imageryType
- इमेज का टाइप बताता है. मान्य वैल्यू,
indoor
औरoutdoor
हैं. date
- इमेज लेने की तारीख. सभी इमेज में तारीख से जुड़ा डेटा नहीं होता है. हालांकि, जब यह फ़ील्ड उपलब्ध होता है, तब इस फ़ील्ड में साल (YYYY) और महीने (MM) का कॉम्बिनेशन शामिल होता है. उदाहरण के लिए: 05-2023 या 2024.
copyright
- वह कॉपीराइट टेक्स्ट जिसे आपको Street View की इमेज के साथ, एट्रिब्यूशन के तौर पर दिखाना होगा.
reportProblemLink
- आपके उपयोगकर्ताओं के लिए एक हाइपरलिंक, ताकि वे इस Street View टाइल की समस्याओं की शिकायत करने के लिए उनका इस्तेमाल कर सकें. आपको यह हाइपरलिंक, इमेज के नीचे दाएं कोने में दिखाना होगा. साथ ही, इसमें ऐसा लिंक टेक्स्ट शामिल होना चाहिए जिसमें "इस इमेज से जुड़ी समस्या की शिकायत करें" जैसा कुछ लिखा हो.
addressComponent
- स्ट्रक्चर्ड जियोकोड इसमें पैनोरामा के पते की जानकारी होती है. ज़्यादा जानकारी के लिए, Geocoding API के दस्तावेज़ में जियोकोडिंग के अनुरोध और जवाब देखें.
links
- इस से लिंक करने वाले पैनोरामा आईडी की सूची. इसमें वह शीर्षक भी होता है जिस पर लिंक मिलता है. उदाहरण के लिए, अगर हेडिंग 180° है, तो लिंक किया गया पैनोरामा, मौजूदा पैनोरामा के दक्षिण में होगा. ध्यान दें कि पैनोरामा आईडी की अस्थायी प्रकृति होती है, इसलिए आपको एक उपयोगकर्ता सेशन से ज़्यादा इन पर भरोसा नहीं करना चाहिए.
Street View के थंबनेल
Street View की तस्वीरों के लिए, thumbnail
फ़ॉर्मैट में अनुरोध किया जा सकता है. थंबनेल ऐसी इमेज होते हैं जो टाइल नहीं की जातीं. इनमें उपयोगकर्ता के हिसाब से साइज़, हेडिंग, पिच, और फ़ील्ड ऑफ़ व्यू होता है.
थंबनेल इमेज का रिज़ॉल्यूशन, टाइल के मुकाबले कम होता है. साथ ही, इन इमेज का साइज़ फ़ाइल
के साइज़ में कम होता है. यहां दिए गए कोड प्रोटोटाइप में बताए गए तरीके के मुताबिक, thumbnail
एंडपॉइंट पर जीईटी अनुरोध भेजकर, थंबनेल का अनुरोध किया जाता है.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
नीचे दिए गए कोड के उदाहरण पर गौर करें, जो कनाडा के व्हिस्लर में ली गई स्ट्रीट व्यू तस्वीरों का एक थंबनेल डाउनलोड करता है.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
ज़रूरी पैरामीटर
panoId
- उस थंबनेल का यूनीक आईडी जो आपको चाहिए. आपको
panoIds
एंडपॉइंट से याmetadata
एंडपॉइंट से पैनोरामा आईडी वैल्यू मिल सकती हैं. ये दोनों वैल्यू भौगोलिक निर्देशांक स्वीकार करती हैं और सहीpanoId
दिखाती हैं. session
- एक मान्य सेशन टोकन.
key
- आपकी एपीआई पासकोड.
ज़रूरी नहीं पैरामीटर
height
- थंबनेल की ऊंचाई पिक्सल में बताता है, जो 16 से लेकर 250 पिक्सल तक हो सकती है. अगर ऊंचाई की जानकारी नहीं दी जाती है, तो ऊंचाई डिफ़ॉल्ट तौर पर 250 पिक्सल की तय सीमा पर सेट हो जाती है. अगर आपने कोई ऐसी वैल्यू डाली है जो रेंज से बाहर है, तो थंबनेल सबसे नज़दीकी मान्य वैल्यू पर स्नैप कर देता है.
width
- थंबनेल की चौड़ाई पिक्सल में तय करता है. यह 16 पिक्सल से लेकर 600 पिक्सल तक होती है. अगर आप चौड़ाई नहीं बताते हैं, तो चौड़ाई डिफ़ॉल्ट रूप से 600 पिक्सल के मंज़ूरी दिए गए मान पर सेट हो जाती है. अगर आपने कोई ऐसी वैल्यू डाली है जो रेंज से बाहर है, तो थंबनेल उस वैल्यू पर स्नैप करता है जो सबसे नज़दीक हो.
pitch
- वर्टिकल ऐक्सिस पर कैमरे का ऐंगल बताता है. मान्य वैल्यू,
-90
से90
की रेंज में हैं. इनमें ये वैल्यू भी शामिल हैं. डिफ़ॉल्ट वैल्यू 0 है. yaw
- हॉरिज़ॉन्टल ऐक्सिस पर कैमरे की दिशा बताता है. मान्य वैल्यू,
-360
से360
की रेंज में हैं. इनमें ये वैल्यू भी शामिल हैं. डिफ़ॉल्ट वैल्यू s 0. fov
- यह हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू के बारे में बताता है, जिसे डिग्री में दिखाया जाता है. इसकी ज़्यादा से ज़्यादा वैल्यू 120 हो सकती है. तय साइज़ के व्यूपोर्ट के साथ काम करते समय, जैसे कि सेट साइज़ वाले Street View की इमेज के लिए, फ़ील्ड ऑफ़ व्यू, ज़ूम दिखाता है. यहां छोटी वैल्यू, ज़्यादा ज़ूम करने के बारे में बताती हैं. डिफ़ॉल्ट तौर पर, यह वैल्यू 90 होती है.
Street View की इमेज की टाइल
panoId
मिलने के बाद, Street View की इमेज वाली टाइल का अनुरोध किया जा सकता है. टाइल
अनुरोध, एचटीटीपीएस जीईटी अनुरोध होते हैं. यह उदाहरण देखें.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
इस कोड उदाहरण में, z
ज़ूम लेवल है. साथ ही, Street View की टाइल के टाइल कोऑर्डिनेट x
और y
हैं. Street View पैनोरामा में ज़ूम लेवल, [0,5] की रेंज में होना चाहिए. इसमें 0 सबसे चौड़ा फ़ील्ड ऑफ़ व्यू दिखाता है.
ज़ूम स्तर | अनुमानित फ़ील्ड ऑफ़ व्यू |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 45° |
4 | 22.5° |
5 | 11.25° |
Street View टाइल से मिले जवाब
Street View की टाइलों का अनुरोध स्वीकार किए जाने पर, उस फ़ॉर्मैट और साइज़ की इमेज दिखेगी जिसे आपने createSession
रिस्पॉन्स में बताया था.
ज़ूम स्तर शून्य पर, पूरे पैनोरामा का आकार बदलकर डाइमेंशन की टाइल
tileWidth
गुणा tileHeight
कर दिया जाता है. x डाइमेंशन में पैनोरामा ज़्यादा बड़े होते हैं,
इसलिए y डाइमेंशन में टाइल में खाली जगह होगी:
ज़ूम स्तर पांच पर, पूरे आकार के पैनोरामा का उपयोग किया जाता है और उसे टाइल में विभाजित किया जाता है.
कॉपीराइट से जुड़ी जानकारी
आपको हर Street View पैनोरामा के साथ कॉपीराइट की जानकारी दिखानी होगी. अलग-अलग पैनोरामा में दिखाई जाने वाली स्ट्रिंग अलग-अलग हो सकती है. कॉपीराइट की जानकारी पाने के लिए, आपको स्ट्रीट व्यू मेटाडेटा का अनुरोध करना होगा. इसके बाद, जवाब के copyright
फ़ील्ड को देखा जा सकता है. ज़्यादा जानकारी के लिए, डेटा एट्रिब्यूशन देखें.