Package google.maps.aerialview.v1

فهرست مطالب

• AerialView (رابط)
• LookupVideoMetadataRequest (پیام)
• LookupVideoRequest (پیام)
• MediaFormat (enum)
• RenderVideoRequest (پیام)
• RenderVideoResponse (پیام)
• Uris (پیام)
• Video (پیام)
• Video.State (عدد)
• VideoMetadata (پیام)

AerialView

تعریف سرویس برای Aerial View API.

LookupVideo

rpc LookupVideo( LookupVideoRequest ) returns ( Video ) یک ویدیو را با توجه به آدرس یا شناسه ویدیوی آن واکشی می کند. پاسخ یا ویدیویی با مجموعه‌ای از URI‌های پخش برای ویدیوهای ACTIVE، وضعیت پردازش برای ویدیوهای در انتظار یا خطای 404 در صورت عدم وجود ویدیو خواهد بود. دریافت یک ویدیو یک رویداد قابل پرداخت است، بنابراین تماس گیرندگان این روش باید در زمان درخواست آماده استفاده از URI های برگشتی باشند. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/cloud-platform

LookupVideoMetadata
rpc LookupVideoMetadata( LookupVideoMetadataRequest ) returns ( VideoMetadata ) فراداده یک ویدیو را با توجه به آدرس یا شناسه ویدیوی آن واکشی می کند. این روش یک جایگزین تماس رایگان برای LookupVideo است و تمام داده‌های ویدیویی موجود به استثنای URI‌های پخش را برمی‌گرداند. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/cloud-platform

RenderVideo
rpc RenderVideo( RenderVideoRequest ) returns ( RenderVideoResponse ) اگر ویدئویی قبلا رندر نشده باشد، آدرسی را به صف رندر اضافه می کند. در غیر این صورت، فراداده مربوط به ویدیو را برمی گرداند. محدوده مجوز به محدوده OAuth زیر نیاز دارد: https://www.googleapis.com/auth/cloud-platform

LookupVideoMetadataRequest

درخواست پیام برای AerialView.LookupVideoMetadata .

زمینه های
key فیلد اتحادیه ضروری. key فقط می تواند یکی از موارد زیر باشد:
video_id	string شناسه ای که از RenderVideo برگردانده شده است.
address	string آدرس پستی آمریکا

LookupVideoRequest

درخواست پیام برای AerialView.LookupVideo .

زمینه های
key فیلد اتحادیه ضروری. کلیدی که برای جستجوی یک ویدیو استفاده می شود. key فقط می تواند یکی از موارد زیر باشد:
video_id	string شناسه ای که از RenderVideo برگردانده شده است.
address	string آدرس پستی آمریکا

MediaFormat

فرمت‌های رسانه‌ای مختلف را که توسط API پشتیبانی می‌شوند را برمی‌شمارد.

Enums
MEDIA_FORMAT_UNSPECIFIED	مقدار پیش فرض.
IMAGE	یک تصویر کوچک.
MP4_HIGH	ویدئو MP4 با کیفیت بالا.
MP4_MEDIUM	ویدئو MP4 با کیفیت متوسط.
MP4_LOW	ویدئو MP4 با کیفیت پایین.
DASH	MPEG-DASH برای پخش نرخ بیت تطبیقی ​​در اکثر دستگاه‌ها.
HLS	HLS برای پخش نرخ بیت تطبیقی ​​در دستگاه‌های اپل.

RenderVideoRequest

درخواست پیام برای AerialView.RenderVideo .

زمینه های
address	string ضروری. یک آدرس پستی ایالات متحده برای موقعیت مکانی که باید در ویدیو ارائه شود.

RenderVideoResponse

پیام پاسخ برای AerialView.RenderVideo .

زمینه های
state	State وضعیت فعلی درخواست رندر.
metadata	VideoMetadata حاوی فراداده ویدیو است، فقط در صورتی تنظیم شود که حالت ACTIVE باشد.

اوریس

شامل تمام اوریس برای یک فرمت ویدیویی معین است.

زمینه های
landscape_uri	string یک URI کوتاه مدت امضا شده برای رسانه در جهت افقی.
portrait_uri	string یک URI کوتاه مدت امضا شده برای رسانه در جهت پرتره.

ویدیو

شیئی که تمام داده های یک ویدیو را در خود محفوظ می دارد.

زمینه های
uris	map<string, Uris > نگاشت انواع رسانه ها به URI آنها. این قسمت فقط برای ویدیوهای ACTIVE گنجانده شده است. کلید یک مقدار enum از MediaFormat است.
state	State وضعیت فعلی درخواست رندر.
metadata	VideoMetadata حاوی فراداده ویدیو است، فقط در صورتی تنظیم شود که حالت ACTIVE باشد.

حالت

حالت های مختلفی که یک ویدیو می تواند در آن باشد.

Enums
STATE_UNSPECIFIED	مقدار پیش فرض. این مقدار استفاده نشده است.
PROCESSING	ویدئو در حال حاضر در حال پردازش است.
ACTIVE	رندر ویدیو به پایان رسیده است و می توان آن را از طریق LookupVideo مشاهده کرد.
FAILED	ویدیو ارائه نشد.

داده های ویدیویی

حاوی ابرداده‌های مربوط به یک ویدیو، مانند شناسه ویدیو و مدت زمان آن.

زمینه های
video_id	string فقط خروجی شناسه ویدیو و روش توصیه شده برای بازیابی ویدیو.
capture_date	Date فقط خروجی تاریخی که در آن تصاویر استفاده شده در ویدیو گرفته شده است. این در سطح یک ماهه خواهد بود.
duration	Duration فقط خروجی طول ویدیو.
state	State فقط خروجی وضعیت فعلی درخواست رندر.