Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

स्ट्रीट लेवल से ली गई इमेज टाइल को जोड़कर, असली पैनोरामिक इफ़ेक्ट बनाया जा सकता है. साथ ही, जगहों के सेट (जैसे, किसी रास्ते) के लिए, ज़्यादा से ज़्यादा 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 के थंबनेल

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"

कोड का यह उदाहरण देखें. इससे कनाडा के व्हिसलर में ली गई 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 मिलता है.panoIdsmetadata
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 फ़ील्ड को देखा जा सकता है. ज़्यादा जानकारी के लिए, डेटा एट्रिब्यूशन देखें.