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

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

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

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

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

सलाह: ज़्यादा जानकारी के लिए, Street View Static API और Street View Service देखें.

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

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

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

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

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

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

   3. Street View टाइल.

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

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) डालें. अनुरोध का मुख्य हिस्सा एक 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, आपके अनुरोध की गई जगहों के लिए कोई पैनोरमा नहीं ढूंढ पाता है, तो ऐरे में उस जगह के लिए कोई स्ट्रिंग नहीं दिखती. उदाहरण के लिए, यहां दिया गया जेएसओएन कोड देखें.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

panoIds का इस्तेमाल इन कामों के लिए किया जा सकता है:

• Street View के मेटाडेटा का अनुरोध करना
• Street View के थंबनेल का अनुरोध करना
• Street View टाइल का अनुरोध करना

ध्यान दें: पैनोरमा आईडी कुछ समय के लिए ही होते हैं. इसका मतलब है कि ये बहुत लंबे समय तक नहीं चलते. आम तौर पर, यह उम्मीद न करें कि Panorama आईडी, उपयोगकर्ता के एक सेशन से ज़्यादा समय तक मान्य रहेंगे.

Street View का मेटाडेटा

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 इमेज का पैनोआईडी पास करना

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

इस पैनोरमा का यूनीक आईडी. आपको इस बात पर भरोसा नहीं करना चाहिए कि Panorama आईडी, उपयोगकर्ता के एक सेशन से ज़्यादा समय तक मान्य रहेंगे.

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

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

links

इससे जुड़े पैनोरमा आईडी की सूची. इसमें वह हेडिंग भी शामिल होती है जिस पर लिंक मिलता है. उदाहरण के लिए, अगर हेडिंग 180° है, तो लिंक किया गया पैनोरमा, मौजूदा पैनोरमा के दक्षिण में होगा. ध्यान दें कि पैनोरमा आईडी, कुछ समय के लिए ही काम करते हैं. इसलिए, आपको एक से ज़्यादा उपयोगकर्ता सेशन के लिए इन पर भरोसा नहीं करना चाहिए.

Street View के थंबनेल

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

ध्यान दें: इस उदाहरण में स्क्वेयर ब्रैकेट में दी गई फ़ील्ड वैल्यू, रेंज दिखाती हैं. उदाहरण के लिए, height की वैल्यू 16 से 250 पिक्सल के बीच हो सकती है.

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

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 पर दिखने वाली तस्वीरें दो सोर्स से मिलती हैं: Google (डेवलपर के कंट्रोल में मौजूद ऐसी तस्वीरें जो सार्वजनिक नहीं हैं) और सार्वजनिक (यूजीसी या सार्वजनिक तौर पर उपयोगकर्ताओं का बनाया कॉन्टेंट). ध्यान दें कि Street View की इमेज के किसी एक सोर्स का इस्तेमाल करने का कोई तरीका नहीं है. Street View की इमेज से जुड़ी निजता नीति के बारे में ज़्यादा जानें.

Street View टाइल से जुड़े जवाब

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

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

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

सलाह: imageHeight और imageWidth को tileHeight और tileWidth से भाग देकर, x और y की ज़्यादा से ज़्यादा वैल्यू का हिसाब लगाया जा सकता है.

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

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