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