מבוא
הבקשות למטא-נתונים של ה-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 דף התמיכה.