איך משתמשים ב-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. לכן אפשר לאחסן ערכים של מזהי סרטונים לשימוש מאוחר יותר.