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

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

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

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

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

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

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

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

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

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

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

   3. Street View टाइल.

Street View के तरीके

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

Street View के panoId की खोज करना

`panoIds` तरीके में, एक या एक से ज़्यादा भौगोलिक जगहों के निर्देशांक (lat, lng) पास करके, उनके पैनोरामा आइडेंटिफ़ायर ढूंढे जा सकते हैं. अनुरोध का मुख्य हिस्सा, 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 की इमेज का 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 एंडपॉइंट पर जीईटी अनुरोध भेजा जाता है. इसे कोड के इस प्रोटोटाइप में दिखाया गया है.

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`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 की इमेज टाइल का अनुरोध किया जा सकता है. टाइल के अनुरोध, एचटीटीपीएस जीईटी अनुरोध होते हैं. यह उदाहरण देखें.

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 टाइल के जवाब

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

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

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

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

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