स्ट्रीट व्यू टाइल

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

• Google Maps की Street View टाइल
• Street View का मेटाडेटा
• Street View के थंबनेल

स्ट्रीट लेवल से ली गई इमेज टाइल को एक साथ जोड़कर, असली दुनिया जैसा पैनोरमिक इफ़ेक्ट बनाया जा सकता है. इसके अलावा, किसी जगह (जैसे, कोई रास्ता) के लिए 100 पैनोरमा आईडी के बारे में क्वेरी की जा सकती है. साथ ही, कैमरे की पोज़िशन के बारे में ज़्यादा जानकारी वाला मेटाडेटा पाया जा सकता है.

Street View Tiles को एक साथ जोड़ने के लिए, व्यूअर की ज़रूरत होती है. उदाहरण के लिए, Street View का कस्टम पैनोरामा व्यूअर.

एपीआई कुंजी मिलने के बाद, Street View की इमेज ऐक्सेस की जा सकती हैं. इसके लिए, यह तरीका अपनाएं.

1. सेशन टोकन पाएं. mapType एट्रिब्यूट की वैल्यू को streetview पर सेट करना न भूलें.

2. सेशन टोकन का इस्तेमाल करके, एक या उससे ज़्यादा भौगोलिक जगहों के पैनोरमा आइडेंटिफ़ायर (panoId) पाएं.

3. पैनो आईडी की खोज के जवाब में मिले पैनोरामा आइडेंटिफ़ायर का इस्तेमाल करके, ये पाएं:

   1. Street View का मेटाडेटा. निर्देशांकों और दायरे का सेट पास करके भी, Street View का मेटाडेटा पाया जा सकता है.

   2. Street View के थंबनेल.

   3. Street View Tiles.

Street View के तरीके

Street View इमेजरी और मेटाडेटा को ऐक्सेस करने के लिए, यहां दिए गए चार तरीकों में से किसी एक का इस्तेमाल करें.

Street View के panoId खोजने की सुविधा

panoIds तरीके का इस्तेमाल करके, एक या उससे ज़्यादा जगहों के पैनोरमा आइडेंटिफ़ायर का पता लगाया जा सकता है. इसके लिए, आपको उन जगहों के निर्देशांक (lat, lng) पास करने होंगे. अनुरोध का मुख्य हिस्सा एक JSON ऑब्जेक्ट होता है. इसमें locations ऐरे और radius शामिल होता है. हालांकि, 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 का मेटाडेटा

स्ट्रीट व्यू मेटाडेटा के अनुरोधों से, पैनोरामा के बारे में जानकारी मिलती है. स्ट्रीट व्यू के मेटाडेटा का अनुरोध, एचटीटीपीएस GET अनुरोध होता है. पैनोरमा के बारे में जानकारी पाने के लिए, इन दोनों में से किसी एक तरीके का इस्तेमाल किया जा सकता है:

• अगर आपने 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 इमेज का 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

यह एक हाइपरलिंक है. इसका इस्तेमाल करके, आपके उपयोगकर्ता इस Street View टाइल से जुड़ी समस्याओं की शिकायत कर सकते हैं. आपको इस हाइपरलिंक को इमेज के नीचे दाएं कोने में दिखाना होगा. साथ ही, इसमें लिंक टेक्स्ट शामिल होना चाहिए. जैसे, "इस इमेज से जुड़ी समस्या की शिकायत करें".

addressComponent

स्ट्रक्चर्ड जियोकोड, जिसमें पैनोरमा के पते के बारे में जानकारी होती है. ज़्यादा जानकारी के लिए, Geocoding API के दस्तावेज़ में जियोकोडिंग के अनुरोध और जवाब देखें.

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 (दोनों शामिल) के बीच होनी चाहिए. डिफ़ॉल्ट वैल्यू 0 है.

fov

यह डिग्री में, हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू के बारे में बताता है. इसकी ज़्यादा से ज़्यादा वैल्यू 120 होती है. जब किसी तय साइज़ वाले व्यूपोर्ट के साथ काम किया जाता है, तो फ़ील्ड ऑफ़ व्यू, ज़ूम को दिखाता है. जैसे, किसी तय साइज़ की Street View इमेज. इसमें छोटी वैल्यू, ज़्यादा ज़ूम लेवल को दिखाती हैं. डिफ़ॉल्ट वैल्यू 90 है.

Street View इमेज टाइल

panoId मिलने के बाद, Street View की इमेज टाइल का अनुरोध किया जा सकता है. टाइल के अनुरोध, एचटीटीपीएस GET अनुरोध होते हैं. नीचे दिया गया उदाहरण देखें.

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 का मतलब है कि फ़ील्ड ऑफ़ व्यू सबसे ज़्यादा है.

Street View Tiles के जवाब

स्ट्रीट व्यू टाइल का अनुरोध स्वीकार होने पर, आपको उस फ़ॉर्मैट और साइज़ की इमेज मिलती है जिसे आपने createSession रिस्पॉन्स में तय किया था.

ज़ूम लेवल शून्य पर, पूरे पैनोरमा का साइज़ बदलकर tileWidth x tileHeight डाइमेंशन वाली टाइल में बदल जाता है. पैनोरामा, x डाइमेंशन में बड़े होते हैं. इसलिए, टाइल में y डाइमेंशन में खाली जगह होगी:

ज़ूम लेवल पांच पर, पूरे साइज़ के पैनोरमा का इस्तेमाल किया जाता है और इसे टाइल में बांटा जाता है.

कॉपीराइट से जुड़ी जानकारी

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