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

מבוא

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

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

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

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

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

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

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

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

הבקשות למטא-נתונים מקבלות את אותם פרמטרים של כתובות 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=<YOUR_SIGNATURE>

או כך:

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

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

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

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

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

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

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

פורמט התשובה

תגובות של מטא-נתונים מוחזרות רק בפורמט 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 יכול להכיל את הערכים הבאים:

מידע נוסף

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