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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מבוא

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

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

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

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

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

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

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

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

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

יש שתי אפשרויות:

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

או:

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

כמו כן:

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

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

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

או כך:

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

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

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

קודי מצב

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

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

מידע נוסף

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