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

Street View का उदाहरणStreet View की टाइल, 2D Tiles से मिलती-जुलती होती हैं. हालांकि, इनमें सड़क के लेवल से ली गई खूबसूरत तस्वीरें होती हैं. 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 की तस्वीरों और मेटाडेटा को ऐक्सेस किया जा सकता है.

तरीका जानकारी
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 बताए गए पैनोरामा के बारे में पूरी जानकारी देता है. जानकारी में इस जगह का पता और पास के पैनोरामा के लिंक शामिल हैं.

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

  • pano_id पास करने पर, Maps Tiles API उस पैनोरामा के लिए मेटाडेटा दिखाता है.

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

टाइल के लिए अनुरोध स्वीकार करने का नतीजा

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

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

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

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