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

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

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

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

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

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

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

שמירת מזהי וידאו לשימוש במועד מאוחר יותר

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