Package google.maps.aerialview.v1

אינדקס

• AerialView (ממשק)
• LookupVideoMetadataRequest (מֶסֶר)
• LookupVideoRequest (מֶסֶר)
• MediaFormat (טיפוסים בני מנייה)
• RenderVideoRequest (מֶסֶר)
• RenderVideoResponse (מֶסֶר)
• Uris (מֶסֶר)
• Video (מֶסֶר)
• Video.State (טיפוסים בני מנייה)
• VideoMetadata (מֶסֶר)

AerialView

הגדרת השירות ל-Aerial View API.

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

פירוט של הפורמטים השונים של המדיה שנתמכים על ידי ה-API.

טיפוסים בני מנייה (enums)
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 סרטונים. המפתח הוא ערך טיפוסים בני מנייה (enum) מ-MediaFormat.
state	State המצב הנוכחי של בקשת העיבוד.
metadata	VideoMetadata מכיל את המטא-נתונים של הסרטון, שמוגדר רק אם המצב הוא ACTIVE.

ארץ

המצבים השונים שבהם הסרטון יכול להופיע.

טיפוסים בני מנייה (enums)
STATE_UNSPECIFIED	ערך ברירת המחדל. הערך הזה לא בשימוש.
PROCESSING	הסרטון נמצא כרגע בתהליך עיבוד.
ACTIVE	עיבוד הסרטון הסתיים וניתן לצפות בו עד LookupVideo.
FAILED	עיבוד הסרטון נכשל.

VideoMetadata

מכיל מטא-נתונים של הסרטון, כמו מזהה הווידאו ומשך הסרטון.

שדות
video_id	string פלט בלבד. מזהה הסרטון והדרך המומלצת לאחזר אותו.
capture_date	Date פלט בלבד. התאריך שבו צולמו התמונות המופיעות בסרטון. התהליך הזה יהיה ברמת פירוט ברמת חודש.
duration	Duration פלט בלבד. אורך הסרטון.
state	State פלט בלבד. המצב הנוכחי של בקשת העיבוד.