כרטיסי Street View דומים ל-
משבצות דו-ממדיות
למעט שהם מכילים תמונות פנורמיות שצולמו ברמת הרחוב. ב-
ב-Street View אפשר לסייר באתרים מפורסמים בעולם, לראות פלאי טבע ולחקור
בתוך מקומות כמו מוזיאונים, אצטדיונים, מסעדות או עסקים קטנים.
נקודת הקצה ב-API מאפשרת גישה אל:
- משבצות Street View במפות Google
- מטא-נתונים של Street View
- תמונות ממוזערות של Street View
תוכל לחבר אריחי תמונה שצולמו מרמת הרחוב כדי ליצור אפקט פנורמי אמיתי. ניתן גם לשלוח שאילתות על עד 100 מזהי פנורמה עבור קבוצה של מיקומים (כמו מסלול), ולקבל מטא-נתונים מפורטים יותר לגבי המצלמה המיקום.
הצופה נדרש לחבר משבצות של Street View יחד. לדוגמה, Street View מציג פנורמה בהתאמה אישית.
אחרי שיש לכם מפתח API, אתם יכולים לגשת לתמונות 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 בשש רמות זום: מ-512 פיקסלים ועד 13,312 פיקסלים. |
https://tile.googleapis.com/v1/streetview/panoIds |
מאפשר לבצע חיפוש בכמות גדולה, עד 100 מיקומים. מחזיר מזהים פנורמיים של כל המיקומים שמכילים תמונות. |
https://tile.googleapis.com/v1/streetview/thumbnail |
מחזירה תמונה ממוזערת בפורמט JPEG של סצנת Street View. מאפשרים לכם לספק כותרת, גובה צליל, מאפיינים ושדה ראייה. המידות המינימליות הן 16x16 פיקסלים. המידות המקסימליות הן 250x600 פיקסלים. |
https://tile.googleapis.com/v1/streetview/metadata |
מספק מידע מפורט על הפנורמה שצוינה. הפרטים כוללים את הכתובת הקשורה וקישורים לתמונות פנורמה סמוכות. |
חיפוש של תמונות פנורמיות ב-Street View
ניתן למצוא את המזהה הפנורמה של מיקום גיאוגרפי אחד או יותר לפי
להעביר את הקואורדינטות שלהן (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
ממשק ה-API של אריחי המפה מנסה למצוא את תמונת הפנורמה הקרובה ביותר לכל מיקום,
ולאחר מכן היא מחזירה את מזהי הפנורמה שלהם. בקשת panoIds
שמבוצעת בהצלחה מחזירה
אובייקט JSON שמכיל מערך panoIds
. המערך מכיל רשימה של
מזהי פנורמה, בסדר שבו ביקשת אותם. אם API של קטעי מפה
לא נמצא תמונות פנורמה עבור המיקומים שביקשת, לאחר מכן שדה ריק
המחרוזת מוחזרת במיקום הזה במערך. לדוגמה, אפשר להיכנס אל
בקוד JSON.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
אפשר להשתמש ב-panoIds
כדי:
- בקשת מטא-נתונים של Street View
- שליחת בקשה להצגת תמונות ממוזערות של Street View
- בקשה לכרטיסי Street View
מטא-נתונים של Street View
בקשות למטא-נתונים של Street View מאחזרות מידע על תמונות פנורמה. רחוב A הבקשה להצגת מטא-נתונים היא בקשת HTTPS 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"
מכיוון שמזהי תמונות פנורמה הם זמניים, מומלץ להעביר
קואורדינטות וערך radius
בבקשה הראשונית למטא נתונים של Street View.
לדוגמה, אפשר לראות את קטע הקוד הבא.
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). למשל: 2023-05 או 2024.
copyright
- הטקסט בנושא זכויות יוצרים שצריך להציג כקרדיט לרחוב הצגת התמונה.
reportProblemLink
- היפר-קישור שבו המשתמשים יכולים להשתמש לדיווח על בעיות ב-Street View הזה הלחצן. עליך להציג את ההיפר-קישור הזה בפינה השמאלית התחתונה של והוא חייב לכלול טקסט קישור עם הכיתוב "דיווח על בעיה". עם התמונה הזו".
addressComponent
- מובנה Geocode (קוד גיאוגרפי) שמכיל פרטים על הכתובת של התמונה הפנורמה. לקבלת מידע נוסף, לראות בקשות ותגובות של קואורדינטות במאמרי העזרה של Geocoding API.
links
- רשימה של מזהים של פנורמה שמקשרים לקובץ הזה. מכיל גם את הכותרת ב- שהקישור נמצא בו. לדוגמה, אם הכותרת היא 180°, אז הפנורמה המקושרת היא מדרום לפנורמה הנוכחית. שימו לב שבגלל הם ארעיים, ולכן לא כדאי להסתמך עליהם מאשר בסשן של משתמש אחד.
תמונות ממוזערות של Street View
אפשר לבקש תמונות Street View בפורמט thumbnail
. תמונות ממוזערות הן
תמונות ללא משבצות עם גודל, כותרת, גובה-רוחב ושדה ראייה שהוגדרו על ידי המשתמש.
לתמונות ממוזערות יש רזולוציה נמוכה יותר ממשבצות, והן קטנות יותר בקובץ
גודל. כדי להגיש בקשה לתמונה ממוזערת, עליך לשלוח בקשת GET אל 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
- מפתח ה-API.
פרמטרים אופציונליים
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. אריחים
הבקשות הן בקשות HTTPS GET. עיינו בדוגמה הבאה.
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 | 19° |
4 | 22.5° |
5 | 11.25° |
תגובות במשבצות Street View
בקשה מוצלחת של משבצת Street View מחזירה תמונה של הפורמט והגודל
שציינת בתשובה שלך ל-createSession
.
ברמת זום אפס, הגודל של כל התמונה הפנורמית משתנה למשבצת של מימדים
tileWidth
על ידי tileHeight
. מכיוון שתמונות פנורמה גדולות יותר בממד ה-x,
האריח יכיל שטח ריק במימד y:
ברמת זום 5, התמונה הפנורמית בגודל מלא מחולקת למשבצות.
מידע על זכויות יוצרים
יש להציג מידע על זכויות יוצרים בכל פנורמה של Street View.
המחרוזת להצגה עשויה להשתנות בין תמונות פנורמיות. כדי לקבל את המידע על זכויות היוצרים,
צריכים לבקש מטא-נתונים של Street View, ואז תוכלו
לעיין בשדה copyright
של התשובה. מידע נוסף זמין במאמר הבא:
ייחוסי נתונים.