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

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

  • 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 की इमेज और मेटाडेटा को ऐक्सेस करने के लिए, यहां दिए गए चार तरीकों में से किसी एक का इस्तेमाल करें.

तरीका ब्यौरा
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 चुने गए पैनोरमा के बारे में ज़्यादा जानकारी देता है. जानकारी में, उस जगह का पता और आस-पास के पैनोरमा के लिंक शामिल होते हैं.

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

कनाडा के व्हिसलर का Street View थंबनेल

ज़रूरी पैरामीटर

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 टाइल से जुड़े जवाब

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

टाइल के अनुरोध को पूरा करने का नतीजा

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

ज़ूम लेवल शून्य

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

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