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