फ़िलहाल, Map Tiles API की झलक (प्री-GA) वर्शन में है. Pre-GA प्रॉडक्ट और सुविधाएं सीमित तौर पर काम कर सकती हैं और pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव शायद अन्य pre-GA वर्शन के साथ काम न करें. Pre-GA ऑफ़र, Google Maps Platform की सेवा की खास शर्तों के दायरे में आते हैं. ज़्यादा जानकारी के लिए, लॉन्च के स्टेज का ब्यौरा देखें.

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

Switch to English

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

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 मेटाडेटा. निर्देशांकों के सेट और रेडियस को पास करके भी स्ट्रीट व्यू मेटाडेटा देखा जा सकता है.
2. Street View के थंबनेल.
3. Street View की टाइल.

Street View के तरीके

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

तरीका	ब्यौरा
`https://tile.googleapis.com/v1/streetview/tiles`	अलग-अलग Street View की टाइल दिखाता है. Street View 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 PanoIds सर्च

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

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

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

कोड के इस उदाहरण में, z ज़ूम लेवल है. साथ ही, आपकी पसंद के Street View टाइल के लिए, x और y टाइल कोऑर्डिनेट हैं. 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 रिस्पॉन्स में बताया है.

Tile अनुरोध पूरा होने का नतीजा

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

ज़ूम स्तर शून्य

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

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

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