מטא-נתונים של תמונות Street View

מבוא

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

הערה: הערך בשדה התאריך יכול להשתנות:

• בשדה התאריך יכולה להיות רמת פירוט שונה בתמונות פנורמיות שונות. לדוגמה, שדה התאריך של חלק מתמונות הפנורמה מכיל שנה וחודש, ואילו אחרים כוללים רק את השנה.
• אם אין נתונים זמינים, שדה התאריך יושמט.

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

בעת שליחת בקשות למטא נתונים של תמונות Street View, התמונות הפנורמיות הוא מדויק עד 50 מטרים.

גישה למטא-נתונים של התמונות

בקשה למטא-נתונים של תמונת Street View היא כתובת URL מסוג HTTP בפורמט הבא:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

הערה: https:// נדרש פרוטוקול לשליחת בקשות למטא-נתונים.

כפי הנהוג בכתובות URL, כל הפרמטרים מופרדים באמצעות סימן אמפרסנד (&), (&).

פרמטרים נדרשים לבקשות מטא-נתונים

בקשות המטא-נתונים מקבלות את אותם פרמטרים של כתובת אתר כמו הבקשות של Street View Static API, למרות שרק הפרמטרים הבאים נדרשים:

למשל:

• location — יכול להיות מחרוזת טקסט (כגון Chagrin Falls, OH) או זוג קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים (40.457375,-80.009353).

או:

• pano — מזהה פנורמה ספציפי. תמונות פנורמה עשויות להשתנות עם הזמן, לכן לא לשמור את המזהה הזה. במקום זאת, יש לשמור את כתובת המיקום או של קווי האורך והרוחב, כדי שתוכלו לרענן את מזהה הפנורמה. עבור אפשר לקרוא פרטים נוספים במאמר בנושא רענון של מזהי פנורמה שנמחקו.

כמו גם:

• key ו-signature – מפתח ה-API נדרש כדי לאמת את בקשה. במקרים מסוימים נדרשת גם חתימה דיגיטלית, מומלץ תמיד. מידע נוסף זמין במאמר הבא: קבלת מפתח וחתימה.

בקשת המטא-נתונים שלכם, עם הפרמטרים הנדרשים בלבד, נראית כך:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=

או כך:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

רענון מזהי פנורמה שנמחקו

אם ניסית לאחזר מזהה פנורמה וקיבלת ZERO_RESULTS או אין ערך, מזהה הפנורמה נמחק וצריך לרענן אותו.

1. שמירת כתובת המיקום או קואורדינטות של קו הרוחב וקו האורך שהשתמשתם בהן קבל מזהה פנורמה כדי שתוכל לרענן במקרה הצורך.

2. אם תזהה שמזהה הפנורמה השתנה, יש להשתמש במיקום המקורי. או קואורדינטות של קו רוחב וקו רוחב כדי לחפש שוב את המיקום הקרוב ביותר של תמונות פנורמה למיקום הזה, ולקבל מזהה פנורמה חדש.

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

פרמטרים אופציונליים לבקשות למטא-נתונים

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

פורמט התשובה

תגובות של מטא-נתונים מוחזרות בפורמט JSON בלבד.

דוגמאות

דוגמה 1: נמצאה פנורמה

כתובות ה-URL הבאות מבקשות בהצלחה את המטא-נתונים והתמונה של פנורמה.

בקשה ותגובה למטא-נתונים

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

במקרה של בקשה ותגובה לתמונה החסרה, שבה צפויה התמונה החסרה.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

יכול להיות שחלק מהדגימות לא זמינות באזור שלך.

דוגמה 2: לא נמצאה פנורמה

כתובות ה-URL הבאות מבקשות את המטא-נתונים ואת התמונה לצילום פנורמה אי אפשר למצוא אותו במיקום שצוין או בקרבתו.

בקשה ותגובה למטא-נתונים

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

בקשה ותגובה לתמונות

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

יכול להיות שחלק מהדגימות לא זמינות באזור שלך.

קודי סטטוס

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

סטטוס	תיאור
"OK"	מציין שלא התרחשו שגיאות. נמצאה פנורמה ומטא-נתונים הוחזרו.
"ZERO_RESULTS"	מציין שלא ניתן היה למצוא תמונות פנורמה בקרבת המיקום שצוין. התגובה הזו עשויה להתרחש אם מספקים מזהה פנורמה לא קיים או לא חוקי. אפשר לעיין במאמר [רענון של מזהי פנורמה שנמחקו](#refresh-pano).
"NOT_FOUND"	מציין שמחרוזת הכתובת שצוינה ב-location הפרמטר לא נמצא. ההודעה הזו יכולה להופיע אם הכתובת לא קיימת ניתנת.
"OVER_QUERY_LIMIT"	מציין שחרגתם מהמכסה היומית או לשנייה ל-API הזה.
"REQUEST_DENIED"	מציין שהבקשה שלך נדחתה. ההודעה הזו עשויה להופיע אם לא לאשר את הבקשה שלך, או אם ה-API הסטטי של Street View לא מופעל הפרויקט במסוף Google Cloud שמכיל את מפתח ה-API שלכם.
"INVALID_REQUEST"	מציין בדרך כלל שהפרמטרים של השאילתה (כתובת, חסרים קואורדינטות של קו רוחב וקו אורך או רכיבים).
"UNKNOWN_ERROR"	מציין שלא ניתן היה לעבד את הבקשה עקב שגיאה בחיבור לשרת. בדרך כלל הבעיה הזו זמנית. לנסות שוב אחרי הבקשה.

מידע נוסף

למידע נוסף על השימוש ב-Street View Static API, או במוצרים אחרים של Google Maps API, חשוב לבדוק את ה-API של מפות Google דף התמיכה.