אריחי Street View

כרטיסי Street View דומים ל- משבצות דו-ממדיות למעט שהם מכילים תמונות פנורמיות שצולמו ברמת הרחוב. ב- ב-Street View אפשר לסייר באתרים מפורסמים בעולם, לראות פלאי טבע ולחקור בתוך מקומות כמו מוזיאונים, אצטדיונים, מסעדות או עסקים קטנים. נקודת הקצה ב-API מאפשרת גישה אל:

• משבצות Street View במפות Google
• מטא-נתונים של Street View
• תמונות ממוזערות של Street View

תוכל לחבר אריחי תמונה שצולמו מרמת הרחוב כדי ליצור אפקט פנורמי אמיתי. ניתן גם לשלוח שאילתות על עד 100 מזהי פנורמה עבור קבוצה של מיקומים (כמו מסלול), ולקבל מטא-נתונים מפורטים יותר לגבי המצלמה המיקום.

הצופה נדרש לחבר משבצות של Street View יחד. לדוגמה, Street View מציג פנורמה בהתאמה אישית.

טיפ: מידע נוסף זמין במאמרים הבאים: ממשק API סטטי של Street View וגם שירות Street View.

אחרי שיש לכם מפתח API, אתם יכולים לגשת לתמונות Street View על ידי ביצוע את השלבים הבאים.

1. מקבלים אסימון סשן. חשוב כדי להגדיר את הערך של mapType ל-streetview.

2. שימוש באסימון הסשן כדי לקבל את מזהה הפנורמה (panoId) של מיקום גיאוגרפי אחד או יותר. מיקומים.

3. משתמשים במזהי הפנורמה מתגובת החיפוש של PanoId כדי לקבל:

   1. מטא-נתונים של Street View. תוכלו גם לקבל תמונות של Street View אפשר להציג מטא-נתונים על ידי העברת קבוצת קואורדינטות ורדיוס.

   2. תמונות ממוזערות של Street View.

   3. כרטיסי מידע של Street View.

הערה: יש להציג מידע על זכויות יוצרים בכל פנורמה של Street View. המחרוזת להצגה עשויה להשתנות בין תמונות פנורמיות. כדי לקבל את זכויות היוצרים צריכים לבקש מטא-נתונים של Street View, תוכלו לעיין בשדה copyright של התשובה.

שיטות של 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 נקודת הקצה, כפי שמוצג באב הטיפוס הבא של הקוד.

הערה: ערכי השדות שמוקפים בסוגריים מרובעים בדוגמה הזו מוצגים טווחים. לדוגמה, height יכול להיות בטווח של 16 עד 250 פיקסלים.

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 משני מקורות: Google (תמונות שלא נמצאות בשליטת המפתחים) והציבור (תוכן שנוצר על ידי משתמשים או תוכן ציבורי שנוצר על ידי משתמשים). חשוב לדעת שאין אפשרות להשתמש רק במקור אחד של Street View הצגת תמונות מעל השנייה. מידע נוסף על מדיניות הפרטיות של תמונות Street View.

תגובות במשבצות Street View

בקשה מוצלחת של משבצת Street View מחזירה תמונה של הפורמט והגודל שציינת בתשובה שלך ל-createSession.

ברמת זום אפס, הגודל של כל התמונה הפנורמית משתנה למשבצת של מימדים tileWidth על ידי tileHeight. מכיוון שתמונות פנורמה גדולות יותר בממד ה-x, האריח יכיל שטח ריק במימד y:

ברמת זום 5, התמונה הפנורמית בגודל מלא מחולקת למשבצות.

טיפ: אפשר לחשב את המקסימום x וגם y על ידי חילוק של imageHeight ו- imageWidth על ידי tileHeight ו-tileWidth.

מידע על זכויות יוצרים

יש להציג מידע על זכויות יוצרים בכל פנורמה של Street View. המחרוזת להצגה עשויה להשתנות בין תמונות פנורמיות. כדי לקבל את המידע על זכויות היוצרים, צריכים לבקש מטא-נתונים של Street View, ואז תוכלו לעיין בשדה copyright של התשובה. מידע נוסף זמין במאמר הבא: ייחוסי נתונים.