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

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

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

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

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

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

תרשים שמציג את תהליך העבודה שמתואר למעלה

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

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