Package google.maps.aerialview.v1

فهرست مطالب

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

فقط خروجی وضعیت فعلی درخواست رندر.