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

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

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

स्ट्रीट लेवल से ली गई इमेज टाइल को एक साथ जोड़कर, असल ज़िंदगी जैसा पैनोरमिक इफ़ेक्ट बनाया जा सकता है. साथ ही, किसी रास्ते जैसी जगहों के सेट के लिए, ज़्यादा से ज़्यादा 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 के पैनोरामा आइडी खोजना

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

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

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

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

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) का कॉम्बिनेशन शामिल होता है. उदाहरण के लिए: 05-2023 या 2024.

copyright

कॉपीराइट टेक्स्ट, जिसे आपको Street View इमेज के साथ एट्रिब्यूशन के तौर पर दिखाना होगा.

reportProblemLink

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

addressComponent

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

links

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

Street View के थंबनेल

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

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 गुणा tileHeight कर दिया जाता है. पैनोरमा, x डाइमेंशन में बड़े होते हैं. इसलिए, टाइल में y डाइमेंशन में खाली जगह होगी:

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

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

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