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

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

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

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

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

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

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

نموداری که گردش کار ذکر شده در بالا را نشان می دهد

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

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