Street View की टाइल, 2D Tiles से मिलती-जुलती होती हैं. हालांकि, इनमें सड़क के लेवल से ली गई खूबसूरत तस्वीरें होती हैं. Street View की मदद से, दुनिया की मशहूर ऐतिहासिक जगहों को एक्सप्लोर किया जा सकता है और कुदरती अजूबे देखे जा सकते हैं. साथ ही, म्यूज़ियम, अरीना, रेस्टोरेंट या छोटे कारोबारों जैसी जगहों के अंदर की जानकारी भी देखी जा सकती है. एपीआई एंडपॉइंट की मदद से, आपको इनका ऐक्सेस मिलता है:
- Google Maps Street View टाइल
- Street View मेटाडेटा
- Street View के थंबनेल
आप सड़क से ली गई इमेज टाइल को एक साथ जोड़कर, असल ज़िंदगी का पैनोरामिक इफ़ेक्ट बना सकते हैं. जगहों के किसी सेट (जैसे कि रास्ता) के लिए, 100 पैनोरामा आईडी तक क्वेरी की जा सकती हैं. साथ ही, कैमरे की पोज़िशन के बारे में ज़्यादा जानकारी वाला मेटाडेटा भी मिल सकता है.
व्यूअर को Street View टाइल्स को एक साथ जोड़ना होगा. उदाहरण के लिए, 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 टाइलें छह ज़ूम लेवल पर हासिल की जा सकती हैं: 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 |
बताए गए पैनोरामा के बारे में पूरी जानकारी देता है. जानकारी में इस जगह का पता और पास के पैनोरामा के लिंक शामिल हैं. |
Street View PanoIds खोज
एक या उससे ज़्यादा भौगोलिक जगहों का पैनोरामा आइडेंटिफ़ायर ढूंढने के लिए, उनके निर्देशांकों (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
पास करने पर, Maps Tiles API उस पैनोरामा के लिए मेटाडेटा दिखाता है.हालांकि,
lat
औरlng
पास करने पर, Maps 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 इमेज का PanoId पास करें
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) का कॉम्बिनेशन होता है. उदाहरण के लिए: 2023-05 या 2024.
copyright
- कॉपीराइट का वह टेक्स्ट जिसे आपको Street View की इमेज के साथ, एट्रिब्यूशन के तौर पर दिखाना चाहिए.
reportProblemLink
- इस 'स्ट्रीट व्यू' टाइल की समस्याओं की शिकायत करने के लिए, आपके उपयोगकर्ताओं के लिए एक हाइपरलिंक. आपको यह हाइपरलिंक, इमेज के सबसे नीचे दाएं कोने में दिखाना होगा. साथ ही, इसमें ऐसा लिंक टेक्स्ट शामिल होना चाहिए जिसमें "इस इमेज से जुड़ी समस्या की शिकायत करें" जैसा कुछ लिखा हो.
addressComponent
- ऐसा स्ट्रक्चर्ड जियोकोड जिसमें पैनोरामा के पते की जानकारी हो. ज़्यादा जानकारी के लिए, जियोकोडिंग एपीआई के दस्तावेज़ में जियोकोडिंग के अनुरोध और उसके जवाब देखें.
links
- इस पैनोरामा से लिंक होने वाले पैनोरामा आईडी की सूची. इसमें वह हेडिंग भी होता है जिस पर लिंक मिला है. उदाहरण के लिए, अगर हेडिंग 180° है, तो लिंक किया गया पैनोरामा मौजूदा पैनोरामा के दक्षिण में होगा. ध्यान दें कि पैनोरामा आईडी की अस्थायी प्रकृति की वजह से, आपको एक उपयोगकर्ता सेशन से ज़्यादा इन पर भरोसा नहीं करना चाहिए.
Street View के थंबनेल
thumbnail
फ़ॉर्मैट में, Street View के लिए तस्वीरों का अनुरोध किया जा सकता है. थंबनेल बिना टाइल वाली इमेज होती हैं. इनका साइज़, हेडिंग, पिच, और फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) होता है.
थंबनेल इमेज का रिज़ॉल्यूशन टाइल के मुकाबले कम होता है और ये फ़ाइल साइज़ में छोटी होती हैं. thumbnail
एंडपॉइंट पर GET अनुरोध भेजकर थंबनेल का अनुरोध किया जाता है, जैसा कि इस कोड प्रोटोटाइप में दिखाया गया है.
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"
उदाहरण के तौर पर दिया गया यह कोड देखें. इसमें व्हिस्लर, कनाडा में ली गई Street View की तस्वीरों का थंबनेल डाउनलोड किया जाता है.
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
ज़ूम लेवल है. साथ ही, x
और y
, Street View टाइल के टाइल कोऑर्डिनेट हैं. Street View पैनोरामा में ज़ूम लेवल
[0,5] की रेंज में होना चाहिए. वहीं, 0 से व्यू का सबसे चौड़ा फ़ील्ड दिखता है.
ज़ूम स्तर | अनुमानित फ़ील्ड ऑफ़ व्यू |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 45° |
4 | 22.5° |
5 | 11.25° |
Street View टाइल से जुड़े जवाब
Street View टाइल के लिए अनुरोध करने पर, आपको उस फ़ॉर्मैट और साइज़ की इमेज दिखेगी जिसे आपने createSession
के जवाब में बताया है.
ज़ूम लेवल शून्य पर, पूरे पैनोरामा का साइज़ बदलकर, डाइमेंशन की टाइल में
tileHeight
x tileWidth
कर दिया गया है. x डाइमेंशन में पैनोरामा बड़े होते हैं,
इसलिए, टाइल में y डाइमेंशन में खाली जगह होगी:
ज़ूम लेवल पांच पर, फ़ुल साइज़ के पैनोरामा का इस्तेमाल किया जाता है और इसे टाइल में बांट दिया जाता है.
कॉपीराइट से जुड़ी जानकारी
आपको हर Street View पैनोरामा के साथ कॉपीराइट की जानकारी दिखानी होगी. दिखाई देने वाली स्ट्रिंग, पैनोरामा के हिसाब से अलग-अलग हो सकती है. कॉपीराइट की जानकारी पाने के लिए
आपको Street View मेटाडेटा का अनुरोध करना होगा. इसके बाद, जवाब के copyright
फ़ील्ड में जाएं. ज़्यादा जानकारी के लिए, डेटा एट्रिब्यूशन देखें.