نحوه استفاده از Aerial View API

API نمای هوایی (Aerial View API) از دو گردش کار کلی پشتیبانی می‌کند. رویکرد شما بستگی به این دارد که آیا ویدیویی که درخواست می‌کنید وجود دارد یا خیر. اگر مطمئن نیستید که ویدیو وجود دارد یا خیر، باید lookupVideoMetadata برای تعیین وضعیت ویدیو استفاده کنید.

گردش کار برای تولید یا بازیابی ویدیوها

برای تولید یا بازیابی یک ویدیوی نمای هوایی از گردش کار زیر استفاده کنید:

1. بررسی کنید که آیا گوگل قبلاً با استفاده از lookupVideoMetadata ویدیویی برای آن مکان ایجاد کرده است یا خیر.
2. اگر ویدیویی وجود ندارد ( lookupVideoMetadata خطای ۴۰۴ را برگرداند)، تابع renderVideo را برای تولید یک ویدیوی جدید فراخوانی کنید.
   1. با استفاده از videoId یا آدرس، تابع lookupVideoMetadata را فراخوانی کنید تا نقطه پایانی را تا زمانی که وضعیت ویدیو ACTIVE شود، بررسی کنید. رندر کردن می‌تواند چندین ساعت طول بکشد، بنابراین از backoff نمایی برای ایجاد فاصله بین فراخوانی‌های خود استفاده کنید.

3. اگر ویدیو فعال است ( lookupVideoMetadata حالت ACTIVE را برگرداند)، تابع lookupVideo را برای دریافت URI های ویدیو فراخوانی کنید.

   توجه: پس از اینکه گوگل ویدیو را برای یک آدرس خاص تولید کرد، آن ویدیو برای همه قابل دسترسی است. یعنی، ویدیو به کاربر یا حساب کاربری خاصی مرتبط نیست.

این گردش کار در نمودار زیر نشان داده شده است:

ذخیره شناسه‌های ویدیو برای استفاده‌های بعدی

با توجه به شرایط خاص سرویس برای Aerial View API، شناسه‌های ویدیویی Aerial View API از محدودیت‌های ذخیره‌سازی ذکر شده در بخش 3.2.3(b)(بدون ذخیره‌سازی) از شرایط خدمات پلتفرم Google Maps معاف هستند. بنابراین می‌توانید مقادیر شناسه ویدیویی را برای استفاده‌های بعدی ذخیره کنید.