איך משתמשים ב-Aerial View API

‫Aerial View API תומך בשני תהליכי עבודה כלליים. הגישה שלכם תלויה בשאלה אם הסרטון שאתם מבקשים קיים או לא. אם אתם לא בטוחים אם הסרטון קיים, כדאי להשתמש ב-lookupVideoMetadata כדי לקבוע את מצב הסרטון.

תהליך עבודה ליצירה או לאחזור של סרטונים

כדי ליצור או לאחזר סרטון תצוגה אווירית, פועלים לפי תהליך העבודה הבא:

1. בודקים אם Google כבר יצרה סרטון למיקום באמצעות lookupVideoMetadata.
2. אם לא קיים סרטון (הוחזרה שגיאת 404), צריך להתקשר אל renderVideo כדי ליצור סרטון חדש.lookupVideoMetadata
   1. מתקשרים אל lookupVideoMetadata באמצעות videoId או הכתובת כדי לשלוח שאילתה לנקודת הקצה עד שהסטטוס של הסרטון יהיה ACTIVE. הרינדור יכול להימשך כמה שעות, לכן מומלץ להשתמש בנסיגה אקספוננציאלית כדי להרווח בין הקריאות.

3. אם הסרטון פעיל (lookupVideoMetadata מחזיר סטטוס של ACTIVE), מתקשרים אל lookupVideo כדי לאחזר את כתובות ה-URI של הסרטון.

   הערה: אחרי ש-Google יוצרת את הסרטון עבור כתובת מסוימת, הסרטון הזה זמין לכולם. כלומר, סרטון לא משויך למשתמש או לחשבון ספציפיים.

תרשים זרימת העבודה הזה מוצג כאן:

שמירת מזהי סרטונים לשימוש מאוחר יותר

בהתאם לתנאים הספציפיים לשירות של Aerial View API, מזהי הסרטונים של Aerial View API פטורים מההגבלות על שמירת נתונים במטמון שמפורטות בסעיף 3.2.3(ב)(ללא שמירה במטמון) של התנאים וההגבלות של Google Maps Platform. לכן אפשר לאחסן ערכים של מזהי סרטונים לשימוש מאוחר יותר.