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

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

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

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

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

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

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

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

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

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

   2. स्ट्रीट व्यू के थंबनेल.

   3. Street View टाइल.

Street View के तरीके

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

तरीका	कंपनी का ब्यौरा
https://tile.googleapis.com/v1/streetview/tiles	अलग-अलग Street View टाइल दिखाता है. Street View Tiles को छह ज़ूम लेवल पर वापस लाया जा सकता है: 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	बताए गए पैनोरामा के बारे में ज़्यादा जानकारी देता है. विवरण में संबंधित पता और आस-पास के पैनोरामा के लिंक शामिल हैं.

स्ट्रीट व्यू पैनोआईडी खोज

आप भौगोलिक जगहों के निर्देशांक (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 को पास करने पर, 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

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

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

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

addressComponent

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

links

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

Street View के थंबनेल

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

नीचे दिए गए कोड के उदाहरण पर गौर करें, जो कनाडा के व्हिस्लर में ली गई स्ट्रीट व्यू तस्वीरों का एक थंबनेल डाउनलोड करता है.

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 ज़ूम लेवल है. साथ ही, Street View की टाइल के टाइल कोऑर्डिनेट x और y हैं. Street View पैनोरामा में ज़ूम लेवल, [0,5] की रेंज में होना चाहिए. इसमें 0 सबसे चौड़ा फ़ील्ड ऑफ़ व्यू दिखाता है.

ज़ूम स्तर	अनुमानित फ़ील्ड ऑफ़ व्यू
0	360°
1	180°
2	90°
3	45°
4	22.5°
5	11.25°

Street View टाइल से मिले जवाब

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

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

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

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

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