Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

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

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

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

एक सेशन टोकन पाएं. पक्का करें कि mapType की वैल्यू streetview पर सेट हो.
एक या एक से ज़्यादा जगहों के पैनोरामा आइडेंटिफ़ायर (panoId) पाने के लिए, सेशन टोकन का इस्तेमाल करें.
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`	तय किए गए पैनोरामा के बारे में ज़्यादा जानकारी देता है. जानकारी में, संबंधित पता और आस-पास के पैनोरामा के लिंक शामिल होते हैं.

Street View के panoId की खोज करना

`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 को, अनुरोध की गई जगहों के लिए कोई पैनोरामा नहीं मिलता है, तो ऐरे में उस जगह के लिए खाली स्ट्रिंग दिखाई जाती है. उदाहरण के लिए, 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 की इमेज का 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: हाइपरलिंक, जिसका इस्तेमाल आपके उपयोगकर्ता, Street View की इस टाइल से जुड़ी समस्याओं की शिकायत करने के लिए कर सकते हैं. आपको यह हाइपरलिंक, इमेज के निचले दाएं कोने में दिखाना होगा. इसमें लिंक का ऐसा टेक्स्ट शामिल होना चाहिए जो "इस इमेज से जुड़ी समस्या की शिकायत करें" जैसा हो.
addressComponent: स्ट्रक्चर्ड जियोकोड जिसमें पैनोरामा के पते के बारे में जानकारी शामिल होती है. ज़्यादा जानकारी के लिए, Geocoding API के दस्तावेज़ में, जियोकोडिंग के अनुरोध और जवाब देखें.
links: पैनोरामा आईडी की सूची, जो इससे लिंक होती है. इसमें वह हेडिंग भी शामिल होती है जिस पर लिंक मिलता है. उदाहरण के लिए, अगर हेडिंग 180° है, तो लिंक किया गया पैनोरामा, मौजूदा पैनोरामा के ठीक दक्षिण में है. ध्यान दें कि पैनोरामा आईडी, कुछ समय के लिए ही मान्य होते हैं. इसलिए, इन्हें सिर्फ़ एक उपयोगकर्ता सेशन के लिए मान्य माना जाना चाहिए.

Street View के थंबनेल

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

कोड का यह उदाहरण देखें. इससे, कनाडा के व्हिसलर में ली गई 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`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 की तस्वीरें दो सोर्स से मिलती हैं: Google (डेवलपर के कंट्रोल वाली, सार्वजनिक तौर पर उपलब्ध नहीं तस्वीरें) और सार्वजनिक तौर पर उपलब्ध (यूजीसी या सार्वजनिक तौर पर उपयोगकर्ता जनरेट किया गया कॉन्टेंट). ध्यान दें कि Street View की तस्वीरों के लिए, सिर्फ़ एक सोर्स का इस्तेमाल नहीं किया जा सकता. Street View की तस्वीरों की निजता नीति के बारे में ज़्यादा जानें.

Street View टाइल के जवाब

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

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

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

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

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

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

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