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

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

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

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

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

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

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

תרשים זרימת העבודה הזה מוצג בהמשך:

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

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