Package google.maps.aerialview.v1

الفهرس

AerialView

تعريف الخدمة لواجهة برمجة تطبيقات Aerial View

LookupVideo

rpc LookupVideo(LookupVideoRequest) returns (Video)

يجلب فيديو يستند إلى عنوانه أو معرّف الفيديو. ستكون الاستجابة إما فيديو به مجموعة من معرفات الموارد المنتظمة (URI) للتشغيل للفيديوهات النشطة، أو حالة "المعالجة" للفيديوهات المعلّقة، أو رسالة الخطأ 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

تعداد تنسيقات الوسائط المختلفة المتوافقة مع واجهة برمجة التطبيقات.

عمليات التعداد
MEDIA_FORMAT_UNSPECIFIED القيمة التلقائية.
IMAGE صورة مصغّرة.
MP4_HIGH فيديو MP4 عالي الجودة
MP4_MEDIUM فيديو MP4 بجودة متوسطة
MP4_LOW فيديو MP4 بجودة منخفضة.
DASH MPEG-DASH لبث معدل نقل البيانات التكيُّفي على معظم الأجهزة.
HLS بروتوكول HLS لبثّ معدل نقل البيانات التكيُّفي على أجهزة Apple.

RenderVideoRequest

طلب رسالة بشأن AerialView.RenderVideo

الحقول
address

string

مطلوبة. تمثّل هذه السمة عنوانًا بريديًا في الولايات المتحدة للموقع الجغرافي الذي سيظهر في الفيديو.

RenderVideoResponse

رسالة الرد على AerialView.RenderVideo.

الحقول
state

State

الحالة الحالية لطلب العرض
metadata

VideoMetadata

يحتوي على البيانات الوصفية للفيديو، ويتم ضبطه فقط إذا كانت الحالة ACTIVE.

أوريس

يحتوي على جميع معرفات الموارد المنتظمة (URI) لتنسيق فيديو معيّن.

الحقول
landscape_uri

string

معرف موارد منتظم (URI) قصير الأجل مُوقَّع للوسائط في اتجاه أفقي.
portrait_uri

string

معرف موارد منتظم (URI) قصير الأجل مُوقَّع للوسائط في الاتجاه العمودي.

حملة فيديو

يشير ذلك المصطلح إلى كائن يتضمّن كل البيانات المتعلّقة بالفيديو.

الحقول
uris

map<string, Uris>

تعيين أنواع الوسائط إلى معرفات الموارد المنتظمة (URI) الخاصة بها. يتم تضمين هذا الحقل لـ ACTIVE فيديو فقط. المفتاح هو قيمة تعداد من MediaFormat.
state

State

الحالة الحالية لطلب العرض
metadata

VideoMetadata

يحتوي على البيانات الوصفية للفيديو، ويتم ضبطه فقط إذا كانت الحالة ACTIVE.

الحالة

الحالات المختلفة التي يمكن أن يتضمّنها الفيديو

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
PROCESSING تجري حاليًا معالجة الفيديو.
ACTIVE تم انتهاء عرض الفيديو، ويمكن مشاهدته حتى LookupVideo.
FAILED تعذّر عرض الفيديو.

VideoMetadata

تحتوي على بيانات وصفية حول الفيديو، مثل videoId ومدته.

الحقول
video_id

string

النتائج فقط. معرّف الفيديو والطريقة المقترَحة لاسترداده
capture_date

Date

النتائج فقط. تاريخ التقاط الصور المُستخدَمة في الفيديو. وسيتم إجراء ذلك على مستوى الشهر.
duration

Duration

النتائج فقط. تمثّل هذه السمة مدة الفيديو.
state

State

النتائج فقط. الحالة الحالية لطلب العرض