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

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

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

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

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

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

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

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

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

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