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

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

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

आप इमेज टाइल को स्टिच करके, रीयल-लाइफ़ पैनोरामिक इफ़ेक्ट. साथ ही, किसी सेट के लिए ज़्यादा से ज़्यादा 100 पैनोरामा आईडी की क्वेरी की जा सकती है और कैमरे के बारे में ज़्यादा जानकारी वाला मेटाडेटा पाने के लिए किया जा सकता है. स्थिति.

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

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

  1. सेशन टोकन पाएं. पक्का करें कि mapType की वैल्यू को streetview पर सेट करने के लिए.

  2. सेशन टोकन का इस्तेमाल इन कामों के लिए करें एक या ज़्यादा भौगोलिक का पैनोरामा आइडेंटिफ़ायर (panoId) पाएं जगहें.

  3. यह पाने के लिए panoId खोज जवाब से पैनोरामा आइडेंटिफ़ायर का इस्तेमाल करें:

    1. Street View मेटाडेटा. आपको Street View की तस्वीरें भी मिल सकती हैं निर्देशांकों का सेट और दायरा पास करके, मेटाडेटा देखें.

    2. स्ट्रीट व्यू के थंबनेल.

    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 बताए गए पैनोरामा के बारे में ज़्यादा जानकारी देता है. विवरण में संबंधित पता और आस-पास के पैनोरामा के लिंक शामिल हैं.

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

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