- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- PhotoSequence
- GpsSource
- Imu
- מדידה3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- רוצים לנסות?
אחרי שהלקוח מסיים להעלות את PhotoSequence
עם ה-UploadRef
שהוחזר, photoSequence.create
מחלץ רצף של תמונות 360 מסרטון או ממטא-נתונים של מכשירים שניתן להרחיב (XDM, http://www.xdm.org/) כדי שיפורסמו ב-Street View במפות Google.
הפונקציה photoSequence.create
מחזירה Operation
, והמזהה PhotoSequence
מוגדר בשדה Operation.name
.
השיטה הזו מחזירה את קודי השגיאה הבאים:
google.rpc.Code.INVALID_ARGUMENT
אם הבקשה בפורמט שגוי.google.rpc.Code.NOT_FOUND
אם קובץ העזר להעלאה לא קיים.
בקשת HTTP
POST https://streetviewpublish.googleapis.com/v1/photoSequence
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
inputType |
חובה. צורת הקלט של |
גוף הבקשה
גוף הבקשה מכיל מופע של PhotoSequence
.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Operation
.
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/streetviewpublish
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
PhotoSequence
רצף של תמונות 360 עם מטא-נתונים.
ייצוג JSON |
---|
{ "id": string, "photos": [ { object ( |
שדות | |
---|---|
id |
פלט בלבד. המזהה הייחודי של רצף התמונות. הוא משמש גם כמזהה פעולה ממושכת אם ההעלאה מתבצעת באופן אסינכרוני. |
photos[] |
פלט בלבד. תמונות שחותמות הזמן שלהן הולכות וגדלות. |
uploadReference |
קלט בלבד. נדרש בעת יצירת רצף תמונות. שם המשאב שאליו מועלים הבייטים של רצף התמונות (כסרטון). |
captureTimeOverride |
זה שינוי אופציונלי. הזמן האבסולוטי בתחילת הצילום של רצף התמונות. אם רצף התמונות הוא סרטון, זוהי שעת ההתחלה של הסרטון. אם השדה הזה יאוכלס בקלט, הוא מבטל את שעת הצילום בסרטון או בקובץ ה-XDM. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
uploadTime |
פלט בלבד. השעה שבה נוצר רצף התמונות הזה בשירות החנות של uSV. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
rawGpsTimeline[] |
קלט בלבד. מדידות GPS גולמיות עם חותמות זמן הולכות וגדלות מהמכשיר שלא מסתנכרנות עם כל תמונה. המדידות הגולמיות האלה ישמשו כדי להסיק את המיקום של כל פריים. נדרש כקלט כאשר קלטType הוא VIDEO ומדידות ה-GPS הגולמיות לא נמצאות ב'מעקב אחר מטא-נתונים של תנועת המצלמה' (CAMM). המשתמש יכול לציין איזה עדיפות מקבל עדיפות באמצעות gpsSource אם מדידות ה-GPS הגולמיות מסופקות גם ב-RAWGpsTimeline וגם ב- Camera Motion Metadata Track (CAMM). |
gpsSource |
קלט בלבד. אם גם RAWGpsTimeline וגם ה- Camera Motion Metadata Track (CAMM) מכילים מדידות GPS, מציינים איזו מהן מקבלת עדיפות. |
imu |
קלט בלבד. נתוני IMU בשלושה צירים לאוסף. אם הנתונים גדולים מדי בשביל הבקשה, הם צריכים לעבור לטראק ה-CAMM של הסרטון. הנתונים האלה תמיד מקבלים עדיפות על פני נתוני CAMM מקבילים, אם קיימים. |
processingState |
פלט בלבד. מצב העיבוד של הרצף הזה. |
failureReason |
פלט בלבד. אם הערך של רצף הזה הואprocessingState = FAILED, למה הוא נכשל. אם ה-processingState הוא ערך אחר כלשהו, השדה הזה לא יהיה מוגדר. |
failureDetails |
פלט בלבד. אם ברצף הזה מוגדרת |
distanceMeters |
פלט בלבד. המרחק המחושב של רצף התמונות במטרים. |
sequenceBounds |
פלט בלבד. תיבה מלבנית שכוללת כל תמונה ברצף התמונות הזה. |
viewCount |
פלט בלבד. המספר הכולל של צפיות שכל התמונות שפורסמו ב-PhotoSequence הזה קיבלו. |
filename |
פלט בלבד. שם הקובץ של התוכן שהעליתם. לא כולל את נתיב הספרייה. האפשרות הזו זמינה רק אם הרצף הועלה בפלטפורמה שמספקת את שם הקובץ. |
GpsSource
המקור הראשי למדידות של GPS.
טיפוסים בני מנייה (enum) | |
---|---|
PHOTO_SEQUENCE |
ה-GPS ב-RawGpsTimeline מקבל עדיפות, אם הוא קיים. |
CAMERA_MOTION_METADATA_TRACK |
GPS ב- Camera Motion Metadata Track (CAMM) מקבל קדימות, אם הוא קיים. |
Imu
נתוני IMU מחיישני המכשיר.
ייצוג JSON |
---|
{ "accelMpsps": [ { object ( |
שדות | |
---|---|
accelMpsps[] |
המדידות של מד התאוצה במטרים/שניות^2 עם חותמות זמן שגדלות בהתאם למכשירים. |
gyroRps[] |
המדידות של הג'ירוסקופ ברדיאנים לשנייה, עם עלייה בחותמות הזמן במכשירים. |
magUt[] |
המדידות של המגנטומטר של השדה המגנטי במיקרו-טסלה (uT) עם עלייה בחותמות הזמן של המכשירים. |
מדידה3d
מדגם גנרי של מדידה בתלת-ממד.
ייצוג JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
שדות | |
---|---|
captureTime |
חותמת הזמן של מדידת ה-IMU. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
x |
מדידת החיישן בציר ה-X. |
y |
מדידת החיישן בציר ה-y. |
z |
מדידת החיישן בציר ה-z. |
ProcessingState
מצב העיבוד של הרצף. המצבים נעים באופן הבא:
+-------------------------+
| |
+---v---+ +----------+ +----+----+
|PENDING+-->PROCESSING+-->PROCESSED|
+---+---+ +----+-----+ +----+----+
| | |
| +--v---+ |
+-------->FAILED<---------+
+------+
הרצף עשוי לעבור למצב FAILED מכל מצב. בנוסף, תמיד אפשר לעבד מחדש רצף מעובד.
טיפוסים בני מנייה (enum) | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
המצב לא צוין. זהו ערך ברירת המחדל. |
PENDING |
עיבוד הרצף עדיין לא התחיל. |
PROCESSING |
הרצף נמצא כרגע בעיבוד. |
PROCESSED |
העיבוד של הרצף הסתיים, כולל שיפור המיקום. |
FAILED |
עיבוד הרצף נכשל. פרטים נוספים מופיעים במאמר 'הסיבה לכשל'. |
ProcessingFailureReason
הסיבות האפשריות לכך שהעיבוד של PhotoSequence
זה נכשל.
טיפוסים בני מנייה (enum) | |
---|---|
PROCESSING_FAILURE_REASON_UNSPECIFIED |
הסיבה לכשל לא צוינה. זהו ערך ברירת המחדל. |
LOW_RESOLUTION |
הרזולוציה של פריים בסרטון קטנה מדי. |
DUPLICATE |
הסרטון הזה הועלה בעבר. |
INSUFFICIENT_GPS |
מעט מדי נקודות GPS. |
NO_OVERLAP_GPS |
אין חפיפה בין מסגרת הזמן של מסלול ה-GPS לבין מסגרת הזמן של הסרטון. |
INVALID_GPS |
ה-GPS לא חוקי (למשל, כל נקודות ה-GPS נמצאות ב-(0,0)) |
FAILED_TO_REFINE_POSITIONS |
אין אפשרות לאתר את רצף התמונות באופן מדויק בעולם. |
TAKEDOWN |
הרצף הוסר מסיבות שקשורות למדיניות. |
CORRUPT_VIDEO |
קובץ הסרטון היה פגום או שלא ניתן לפענח אותו. |
INTERNAL |
אירעה תקלה קבועה במערכת הבסיסית. |
INVALID_VIDEO_FORMAT |
הפורמט של הסרטון לא נתמך או שהוא לא תקין. |
INVALID_VIDEO_DIMENSIONS |
נמצא יחס גובה-רוחב לא חוקי של התמונה. |
INVALID_CAPTURE_TIME |
חותמות הזמן לא תקינות. חותמות הזמן היו עתידיות. |
GPS_DATA_GAP |
בנתוני ה-GPS יש פער של יותר מ-5 שניות. |
JUMPY_GPS |
נתוני ה-GPS איטיים מדי מכדי לעבד אותם. |
INVALID_IMU |
נתוני IMU (מד תאוצה, ג'יירוסקופ וכו') אינם חוקיים. ייתכן שחסרים בהם שדות חובה (x, y, z או שעה), שהפורמט שלהם לא תקין או בגלל בעיה אחרת שמונעת מהמערכות שלנו לנתח אותם. |
INSUFFICIENT_IMU |
יש מעט מדי נקודות IMU. |
INSUFFICIENT_OVERLAP_TIME_SERIES |
אין מספיק חפיפה במסגרת הזמן בין נתוני GPS, IMU ונתונים אחרים של סדרת זמנים. |
IMU_DATA_GAP |
בנתוני IMU (מד תאוצה, ג'יירוסקופ וכו') יש פערים של יותר מ-0.1 שניות. |
UNSUPPORTED_CAMERA |
המצלמה לא נתמכת. |
NOT_OUTDOORS |
חלק מהפריימים היו בתוך מבנים, לכן אין תמיכה בשיטה הזו. |
INSUFFICIENT_VIDEO_FRAMES |
אין מספיק פריימים. |
INSUFFICIENT_MOVEMENT |
אין מספיק נתונים מועברים. |
ProcessingFailureDetails
פרטים נוספים שנלווים ל-ProcessFailureReason enum. תמיד צריך להשתמש בהודעה הזו בשילוב עם ProcessingFailureReason, והערך של אחד מהסטטוסים בהודעה הזו צריך להיות תואם ל-"NegativeReason".
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד details . תוגדר רק קבוצת פרטים אחת, והיא צריכה להתאים ל-enum המתאים ב-ProcessFailureReason. details יכול להיות רק אחת מהאפשרויות הבאות: |
|
insufficientGpsDetails |
פרטים נוספים מופיעים כאן: InsufficientGpsFailureDetails. |
gpsDataGapDetails |
פרטים נוספים זמינים ב-GpsDataGapFailureDetails. |
imuDataGapDetails |
פרטים נוספים זמינים ב-ImuDataGapFailureDetails. |
notOutdoorsDetails |
פרטים נוספים זמינים ב-NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
פרטים נוספים זמינים ב-NoOverlapGpsFailureDetails. |
InsufficientGpsFailureDetails
פרטים שקשורים ל-ProcessFailureReason#INSUFFICIENT_GPS.
ייצוג JSON |
---|
{ "gpsPointsFound": integer } |
שדות | |
---|---|
gpsPointsFound |
מספר נקודות ה-GPS שנמצאו בסרטון. |
GpsDataGapFailureDetails
פרטים שקשורים ל-ProcessFailureReason#GPS_DATA_GAP. אם יש פערים רבים בנתוני ה-GPS, רק הפער עם משך הזמן הגדול ביותר מדווח כאן.
ייצוג JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
שדות | |
---|---|
gapDuration |
משך הפער בנתוני ה-GPS שנמצא. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
gapStartTime |
הזמן היחסי (מתחילת שידור הווידאו) כשהתחלת הפער. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
ImuDataGapFailureDetails
פרטים שקשורים ל-ProcessFailureReason#IMU_DATA_GAP. אם יש מספר פערים בנתונים של ה-IMU, רק הפער עם משך הזמן הארוך ביותר מדווח כאן.
ייצוג JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
שדות | |
---|---|
gapDuration |
משך הזמן שבו נמצא הפער בנתוני ה-IMU. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
gapStartTime |
הזמן היחסי (מתחילת שידור הווידאו) כשהתחלת הפער. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
NotOutdoorsFailureDetails
פרטים שקשורים ל-ProcessFailureReason#NOT_OUTDOORS. אם נמצאו כמה מסגרות בתוך מבנים, הפריים הראשון מתועד כאן.
ייצוג JSON |
---|
{ "startTime": string } |
שדות | |
---|---|
startTime |
הזמן היחסי (מתחילת שידור הווידאו) כשנמצאה מסגרת פנימית. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
NoOverlapGpsFailureDetails
פרטים שקשורים ל-PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
ייצוג JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
שדות | |
---|---|
gpsStartTime |
זמן של נקודת ה-GPS המתועדת הראשונה. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
gpsEndTime |
השעה של נקודת ה-GPS המתועדת האחרונה. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
videoStartTime |
שעת ההתחלה של הסרטון. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
videoEndTime |
שעת הסיום של הסרטון. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
LatLngBounds
מלבן בקואורדינטות גיאוגרפיות.
ייצוג JSON |
---|
{ "southwest": { object ( |
שדות | |
---|---|
southwest |
הפינה הדרום-מערבית של הגבולות האלה. |
northeast |
הפינה הצפון-מזרחית של גבולות אלה. |
InputType
צורות קלט של PhotoSequence
.
טיפוסים בני מנייה (enum) | |
---|---|
INPUT_TYPE_UNSPECIFIED |
לא צוין. השרת יחזיר את הערך google.rpc.Code.INVALID_ARGUMENT . |
VIDEO |
וידאו 360. |
XDM |
מטא-נתונים של מכשיר שניתן להרחבה, http://www.xdm.org |