इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

Street View टाइल का उदाहरण

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

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

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

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

एक बार आपके पास API कुंजी हो जाने पर, आप निम्न चरणों का पालन करके स्ट्रीट व्यू इमेजरी तक पहुंच सकते हैं.

सेशन टोकन पाएं. mapType एट्रिब्यूट की वैल्यू को streetview पर सेट करना न भूलें.
सेशन टोकन का इस्तेमाल करके, एक या उससे ज़्यादा भौगोलिक जगहों के पैनोरमा आइडेंटिफ़ायर (panoId) पाएं.
पैनो आईडी की खोज के जवाब में मिले पैनोरामा आइडेंटिफ़ायर का इस्तेमाल करके, ये पाएं:
1. स्ट्रीट व्यू मेटाडेटा. निर्देशांकों और दायरे का सेट पास करके भी, Street View का मेटाडेटा पाया जा सकता है.
2. स्ट्रीट व्यू थंबनेल.
3. स्ट्रीट व्यू टाइल्स.

Street View के तरीके

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

तरीका	ब्यौरा
`https://tile.googleapis.com/v1/streetview/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`	इससे चुने गए पैनोरामा के बारे में ज़्यादा जानकारी मिलती है. जानकारी में आस-पास के पते और आस-पास के पैनोरमा के लिंक शामिल होते हैं.

Street View के panoId खोजने की सुविधा

panoIds तरीके में, एक या उससे ज़्यादा जगहों के निर्देशांक (lat, lng) पास करके, उनके पैनोरमा आइडेंटिफ़ायर का पता लगाया जा सकता है. अनुरोध का मुख्य हिस्सा एक JSON ऑब्जेक्ट होता है. इसमें locations ऐरे और radius शामिल होता है. हालांकि, 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 टाइल का अनुरोध करना

सड़क दृश्य मेटाडेटा

स्ट्रीट व्यू मेटाडेटा अनुरोध पैनोरमा के बारे में जानकारी प्राप्त करते हैं. स्ट्रीट व्यू मेटाडेटा अनुरोध एक HTTPS GET अनुरोध है. पैनोरमा के बारे में जानकारी पाने के लिए, इन दोनों में से किसी एक तरीके का इस्तेमाल किया जा सकता है:

अगर आप pano_id पास करते हैं, तो मैप टाइल्स API उस पैनोरमा के लिए मेटाडेटा लौटाता है.
लेकिन अगर आप lat और lng पास करते हैं, तो मैप टाइल्स एपीआई दिए गए खोज दायरे में सबसे नज़दीकी पैनोरमा के लिए मेटाडेटा लौटाता है.

निर्देशांकों का सेट और रेडियस पास करें

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"

स्ट्रीट व्यू इमेज का पैनोआईडी पास करें

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: यह एक हाइपरलिंक है. इसका इस्तेमाल करके, आपके उपयोगकर्ता इस 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

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

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 है.

सड़क दृश्य छवि टाइल्स

panoId मिलने के बाद, Street View की इमेज टाइल का अनुरोध किया जा सकता है. टाइल अनुरोध HTTPS GET अनुरोध हैं. नीचे दिया गया उदाहरण देखें.

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

इस कोड उदाहरण में, z ज़ूम स्तर है, और x और y आपके इच्छित स्ट्रीट व्यू टाइल के टाइल निर्देशांक हैं. स्ट्रीट व्यू पैनोरमा में ज़ूम स्तर [0,5] की सीमा में होना चाहिए, जिसमें 0 दृश्य के सबसे विस्तृत क्षेत्र का प्रतिनिधित्व करता है.

ज़ूम स्तर	अनुमानित दृश्य क्षेत्र
0	360°
1	180°
2	90°
3	45°
4	22.5°
5	11.25°

ध्यान दें: Street View की इमेज दो सोर्स से मिलती हैं: Google (डेवलपर के कंट्रोल वाली ऐसी इमेज जो सार्वजनिक नहीं होती हैं) और सार्वजनिक तौर पर उपलब्ध इमेज (यूजीसी या सार्वजनिक तौर पर उपलब्ध यूज़र जनरेटेड कॉन्टेंट). ध्यान दें कि Street View की इमेज के लिए, सिर्फ़ एक सोर्स का इस्तेमाल करने का कोई तरीका नहीं है. स्ट्रीट व्यू की इमेज के लिए बनी निजता नीति के बारे में ज़्यादा जानें.

Street View Tiles के जवाब

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

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

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

ज़ूम लेवल ज़ीरो

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

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

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