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