मैप की नई स्टाइल, जल्द ही Google Maps Platform पर उपलब्ध होगी. मैप की स्टाइल में हुए इस अपडेट में, नया डिफ़ॉल्ट कलर पटल जोड़ा गया है. साथ ही, मैप के अनुभवों और उसे इस्तेमाल करने के तरीके में सुधार भी किए गए हैं. मार्च 2025 में, सभी मैप स्टाइल अपने-आप अपडेट हो जाएंगी. उपलब्धता और जल्दी ऑप्ट इन करने के तरीके के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform के लिए नई मैप स्टाइल देखें.

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

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

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

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`	स्ट्रीट व्यू के किसी सीन का थंबनेल दिखाने वाली JPEG इमेज दिखाता है. इसकी मदद से हेडिंग, पिच, डाइमेंशन, और फ़ील्ड ऑफ़ व्यू दिया जा सकता है. डाइमेंशन कम से कम 16x16 पिक्सल होने चाहिए. डाइमेंशन ज़्यादा से ज़्यादा 250x600 पिक्सल होने चाहिए.
`https://tile.googleapis.com/v1/streetview/metadata`	चुने गए पैनोरमा के बारे में ज़्यादा जानकारी देता है. जानकारी में, उस जगह का पता और आस-पास के पैनोरमा के लिंक शामिल होते हैं.

Street View के पैनोरामा आइड खोजने की सुविधा

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

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

panoIds का इस्तेमाल इन कामों के लिए किया जा सकता है:

Street View के मेटाडेटा का अनुरोध करना
Street View के थंबनेल का अनुरोध करना
Street View टाइल का अनुरोध करना

Street View का मेटाडेटा

Street View के मेटाडेटा के अनुरोधों से, पैनोरमा के बारे में जानकारी मिलती है. Street View का मेटाडेटा अनुरोध, एचटीटीपीएस GET अनुरोध होता है. पैनोरमा के बारे में जानकारी पाने के लिए, इनमें से कोई एक तरीका अपनाएं:

अगर 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 इमेज का पैनोआईडी पास करना

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

Street View के थंबनेल

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

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