Street View टाइल, मिलती-जुलती हैं
2D टाइल
लेकिन उनमें सड़क स्तर पर ली गई पैनोरामिक इमेजरी होती है. के साथ
Street View की मदद से, दुनिया की मशहूर जगहों को एक्सप्लोर किया जा सकता है, प्राकृतिक अजूबे देखे जा सकते हैं, और सीढ़ियों को
जगहें, जैसे कि म्यूज़ियम, अरीना, रेस्टोरेंट या छोटे कारोबार.
इस एपीआई एंडपॉइंट से आपको इनका ऐक्सेस मिलता है:
- Google Maps Street View टाइल
- Street View का मेटाडेटा
- Street View के थंबनेल
आप इमेज टाइल को स्टिच करके, रीयल-लाइफ़ पैनोरामिक इफ़ेक्ट. साथ ही, किसी सेट के लिए ज़्यादा से ज़्यादा 100 पैनोरामा आईडी की क्वेरी की जा सकती है और कैमरे के बारे में ज़्यादा जानकारी वाला मेटाडेटा पाने के लिए किया जा सकता है. स्थिति.
दर्शक को Street View टाइल को एक साथ जोड़ना होगा. उदाहरण के लिए, स्ट्रीट व्यू कस्टम पैनोरामा व्यूअर.
एपीआई पासकोड हासिल करने के बाद, Street View की तस्वीरें ऐक्सेस करने के लिए, यहां दिया गया तरीका अपनाएं.
सेशन टोकन पाएं. पक्का करें कि
mapType
की वैल्यू कोstreetview
पर सेट करने के लिए.सेशन टोकन का इस्तेमाल इन कामों के लिए करें एक या ज़्यादा भौगोलिक का पैनोरामा आइडेंटिफ़ायर (panoId) पाएं जगहें.
यह पाने के लिए panoId खोज जवाब से पैनोरामा आइडेंटिफ़ायर का इस्तेमाल करें:
Street View मेटाडेटा. आपको 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 |
बताए गए पैनोरामा के बारे में ज़्यादा जानकारी देता है. विवरण में संबंधित पता और आस-पास के पैनोरामा के लिंक शामिल हैं. |
स्ट्रीट व्यू पैनोआईडी खोज
आप इसके अनुसार एक या ज़्यादा भौगोलिक स्थानों का पैनोरामा आइडेंटिफ़ायर पा सकते हैं
अपने निर्देशांक (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 मेटाडेटा के अनुरोध, पैनोरामा के बारे में जानकारी हासिल करते हैं. सड़क मेटाडेटा देखने का अनुरोध, एचटीटीपीएस जीईटी अनुरोध है. जानकारी वापस मिल सकती है इनमें से किसी एक तरीके से पैनोरामा के बारे में जानकारी मिलेगी:
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
- इस पैनोरामा का यूनीक आईडी. आपको पैनोरामा आईडी पर भरोसा नहीं करना चाहिए कि एक से ज़्यादा समय के लिए मान्य होता है.
lat
,lng
- पैनोरामा के निर्देशांक (अक्षांश और देशांतर). ये वैल्यू यह आपके अनुरोध में पास किए गए निर्देशांकों से अलग होता है, क्योंकि जगह के सबसे नज़दीक के पैनोरामा पर स्नैप करता है.
imageHeight
,imageWidth
- स्टिच की गई पैनोरामा इमेज के डाइमेंशन.
tileHeight
,tileWidth
- एक पैनोरामा टाइल के डाइमेंशन.
heading
- कंपास का हेडिंग, उत्तर से घड़ी की सुई की दिशा में डिग्री में मापा गया. टाइटल ये हैं वैल्यू, [0,360] की रेंज में आती है. इसमें 0 का मतलब है कि जवाब उत्तर की ओर है.
tilt
- पैनोरामा का झुकाव, जिसे पैनोरामा के दक्षिणी ध्रुव से डिग्री में मापा गया है में से एक को भी चुनें. दी गई वैल्यू, [0, 180] की रेंज के अंदर हैं. मान का 90 डिग्री संकेत देता है कि क्षितिज पहले से ही के भूमध्य रेखा पर अलाइन है पैनोरामा.
roll
- दृष्टि रेखा के चारों ओर घड़ी की सुई की दिशा में घुमाना जिसे पैनोरामा जैसी कोई चीज़ चुनें. दी गई वैल्यू, [0, 360] की रेंज के अंदर हैं.
imageryType
- इमेज का टाइप बताता है. मान्य वैल्यू,
indoor
औरoutdoor
हैं. date
- इमेज लेने की तारीख. सभी इमेज में तारीख से जुड़ा डेटा नहीं होता है. हालांकि, जब यह उपलब्ध है, इस फ़ील्ड में साल (YYYY) और महीने का कॉम्बिनेशन होता है (MM). उदाहरण के लिए: 05-2023 या 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 की इमेज वाली टाइल का अनुरोध किया जा सकता है. टाइल
अनुरोध, एचटीटीपीएस जीईटी अनुरोध होते हैं. नीचे दिया गया उदाहरण देखें.
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 की टाइलें हैं. स्ट्रीट व्यू पैनोरामा में ज़ूम लेवल को ज़रूर देखना चाहिए
[0,5] की रेंज में होना चाहिए, जहां 0 सबसे चौड़ी फ़ील्ड को दिखाता है.
ज़ूम स्तर | अनुमानित फ़ील्ड ऑफ़ व्यू |
---|---|
0 | 360° |
1 | 180° |
2 | 90° |
3 | 45° |
4 | 22.5° |
5 | 11.25° |
Street View टाइल से मिले जवाब
Street View की टाइलों का अनुरोध पूरा होने पर, आपको इमेज के फ़ॉर्मैट और साइज़ की इमेज दिखेगी
जिसे आपने अपने createSession
जवाब में बताया था.
ज़ूम लेवल शून्य पर, पूरे पैनोरामा का साइज़, डाइमेंशन की टाइल में बदल दिया जाता है
tileHeight
का tileWidth
. x डाइमेंशन में पैनोरामा ज़्यादा बड़े होते हैं, इसलिए
टाइल में y डाइमेंशन में खाली जगह होगी:
ज़ूम स्तर पांच पर, पूरे आकार के पैनोरामा का उपयोग किया जाता है और उसे टाइल में विभाजित किया जाता है.
कॉपीराइट से जुड़ी जानकारी
आपको हर Street View पैनोरामा के साथ कॉपीराइट की जानकारी दिखानी होगी. कॉन्टेंट बनाने
दिखाई जाने वाली स्ट्रिंग पैनोरामा के बीच अलग-अलग हो सकती है. कॉपीराइट की जानकारी पाने के लिए,
Street View मेटाडेटा के लिए अनुरोध करना होगा. इसके बाद,
जवाब के copyright
फ़ील्ड को देखें. ज़्यादा जानकारी के लिए, यह देखें
डेटा एट्रिब्यूशन.