מטא-נתונים של תמונות 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.