- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- PhotoSequence
- GpsSource
- אימו
- Measurement3d
- 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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
uploadTime |
פלט בלבד. השעה שבה רצף התמונות הזה נוצר בשירות החנות של uSV. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
rawGpsTimeline[] |
קלט בלבד. מדידות GPS גולמיות עם חותמות זמן שגדלות ועולות מהמכשיר, שלא מסתנכרנות עם כל תמונה בזמן. המדידות הגולמיות האלה ישמשו כדי להסיק את התנוחה של כל מסגרת. נדרש בקלט כאשר שיטת הקלט היא VIDEO ומדידות GPS גולמיות לא נכללות במעקב המטא-נתונים של תנועת המצלמה (CAMM). המשתמש יכול לציין איזו מהן מקבלת עדיפות באמצעות gpsSource, אם מדידות GPS גולמיות זמינות גם ב-RAWGTimeline וגם ב-camera Motion Metadata Track (CAMM). |
gpsSource |
קלט בלבד. אם גם RAWGpsTimeline וגם ה- Camera Motion Metadata Track (CAMM) מכילים מדידות GPS, יש לציין איזו מהן מקבלת עדיפות. |
imu |
קלט בלבד. נתוני IMU עם שלושה צירים לאוסף. אם הנתונים האלה גדולים מדי ולא ניתן לכלול אותם בבקשה, צריך להוסיף אותם למסלול CAMM של הסרטון. הנתונים האלה תמיד מקבלים עדיפות על פני נתוני CAMM מקבילים, אם הם קיימים. |
processingState |
פלט בלבד. מצב העיבוד של הרצף הזה. |
failureReason |
פלט בלבד. אם הרצף הזה מכיל paymentState = FAILED, תוצג בו הסיבה לכך. אם ה-processingState הוא ערך אחר כלשהו, השדה הזה לא יוגדר. |
failureDetails |
פלט בלבד. אם הרצף הזה מוגדר כ- |
distanceMeters |
פלט בלבד. המרחק המחושב של רצף התמונות במטרים. |
sequenceBounds |
פלט בלבד. תיבה מלבנית המקיפה כל תמונה ברצף התמונות הזה. |
viewCount |
פלט בלבד. מספר הצפיות הכולל שקיבלו כל התמונות שפורסמו ברצף התמונות הזה. |
filename |
פלט בלבד. שם הקובץ של ההעלאה. לא כולל את נתיב הספרייה. האפשרות הזו זמינה רק אם הרצף הועלה לפלטפורמה שמספקת את שם הקובץ. |
GpsSource
המקור העיקרי של מדידות GPS.
טיפוסים בני מנייה (enums) | |
---|---|
PHOTO_SEQUENCE |
ל-GPS ב-RAWGpsTimeline יש עדיפות אם הוא קיים. |
CAMERA_MOTION_METADATA_TRACK |
ל-GPS בערוץ המטא-נתונים של המצלמה (CAMM) יש עדיפות אם הוא קיים. |
אימו
נתוני IMU מחיישני המכשיר.
ייצוג JSON |
---|
{ "accelMpsps": [ { object ( |
שדות | |
---|---|
accelMpsps[] |
מד התאוצה נמדד במטרים לשנייה ב^2 עם חותמות זמן גדלות ממכשירים. |
gyroRps[] |
מדידות הג'ירוסקופ ברדיאנים לשנייה עם חותמות זמן במכשירים שגדלות. |
magUt[] |
מדידות המגנטומטר של השדה המגנטי במיקרו-טסלה (uT) עם עלייה בחותמות הזמן ממכשירים. |
מדידה3d
דגימה כללית של מדידת תלת ממד.
ייצוג JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
שדות | |
---|---|
captureTime |
חותמת הזמן של מדידת ה-IMU. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
x |
מדידת החיישן בציר ה-x. |
y |
מדידת החיישן בציר ה-y. |
z |
מדידת החיישן בציר ה-z. |
ProcessingState
מצב העיבוד של הרצף. המצבים משתנים באופן הבא:
+-------------------------+
| |
+---v---+ +----------+ +----+----+
|PENDING+-->PROCESSING+-->PROCESSED|
+---+---+ +----+-----+ +----+----+
| | |
| +--v---+ |
+-------->FAILED<---------+
+------+
הרצף עשוי לעבור לסטטוס 'נכשל' מכל מצב. בנוסף, בכל שלב ניתן לעבד מחדש רצף שעבר עיבוד.
טיפוסים בני מנייה (enums) | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
לא צוין מצב, זהו ערך ברירת המחדל. |
PENDING |
עיבוד הרצף עוד לא התחיל. |
PROCESSING |
הרצף נמצא כרגע בתהליך עיבוד. |
PROCESSED |
העיבוד של הרצף הסתיים, כולל מיקום הצמצום. |
FAILED |
עיבוד הרצף נכשל. לפרטים נוספים, אפשר לעיין ב'סיבת הכשל'. |
ProcessingFailureReason
הסיבות האפשריות לכך שהעיבוד של PhotoSequence
נכשל.
טיפוסים בני מנייה (enums) | |
---|---|
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
פרטים נוספים שנלווים לטיפוסים של אי-העיבוד. יש להשתמש תמיד בהודעה הזו בשילוב עם AcceptFailureReason, והערך שמוגדר בהודעה הזו צריך להתאים ל-failureReason.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד details . רק קבוצה אחת של פרטים תוגדר, והיא חייבת להתאים לטיפוסים הטיפוסיים (enum) המתאימים ב-processingFailureReason. הערך של details יכול להיות רק אחת מהאפשרויות הבאות: |
|
insufficientGpsDetails |
למידע נוסף, ניתן לעיין בקטע InsufficientGpsFailureDetails. |
gpsDataGapDetails |
פרטים נוספים זמינים בקטע GpsDataGapFailureDetails. |
imuDataGapDetails |
מידע נוסף זמין ב-ImuDataGapFailureDetails. |
notOutdoorsDetails |
ראו NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
מידע נוסף זמין ב-NoOverlapGpsFailureDetails. |
InsufficientGpsFailureDetails
פרטים שקשורים לעיבודFailureReason#INSUFFICIENT_GPS.
ייצוג JSON |
---|
{ "gpsPointsFound": integer } |
שדות | |
---|---|
gpsPointsFound |
מספר נקודות ה-GPS שנמצאו בסרטון. |
GpsDataGapFailureDetails
פרטים שקשורים לעיבודFailureReason#GPS_DATA_GAP. אם קיימים מספר פערים בנתוני ה-GPS, יוצג כאן רק היעד עם משך הזמן הגבוה ביותר.
ייצוג JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
שדות | |
---|---|
gapDuration |
משך הזמן של הפער בנתוני ה-GPS שנמצאו. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
gapStartTime |
הזמן היחסי (מתחילת שידור הווידאו) מרגע שהפער התחיל. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
ImuDataGapFailureDetails
פרטים הקשורים לעיבודFailureReason#IMU_DATA_GAP. אם יש כמה פערים בנתונים של מכשיר IMU, רק המדד עם משך הזמן הארוך ביותר מדווח כאן.
ייצוג JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
שדות | |
---|---|
gapDuration |
משך הפער בנתוני ה-IMU שנמצא. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
gapStartTime |
הזמן היחסי (מתחילת שידור הווידאו) מרגע שהפער התחיל. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
NotOutdoorsFailureDetails
פרטים הקשורים לעיבודFailureReason#NOT_OUTDOORS. אם נמצאו כמה מסגרות מקורות, הפריים הראשון מתועד כאן.
ייצוג JSON |
---|
{ "startTime": string } |
שדות | |
---|---|
startTime |
זמן יחסי (מתחילת שידור הווידאו) כאשר נמצאה פריים מקורה. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
NoOverlapGpsFailureDetails
פרטים הקשורים ל-PhotoSequenceSequenceFailureReason#NO_OVERLAP_GPS.
ייצוג JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
שדות | |
---|---|
gpsStartTime |
שעת ההקלטה הראשונה של נקודת ה-GPS. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
gpsEndTime |
שעת ההקלטה האחרונה של נקודת ה-GPS. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
videoStartTime |
שעת ההתחלה של הסרטון. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
videoEndTime |
שעת הסיום של הסרטון. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
LatLngBounds
מלבן בקואורדינטות גיאוגרפיות.
ייצוג JSON |
---|
{ "southwest": { object ( |
שדות | |
---|---|
southwest |
הפינה הדרום-מערבית של גבולות אלה. |
northeast |
הפינה הצפון-מזרחית של גבולות אלה. |
InputType
צורות קלט של PhotoSequence
.
טיפוסים בני מנייה (enums) | |
---|---|
INPUT_TYPE_UNSPECIFIED |
לא צוין. השרת יחזיר google.rpc.Code.INVALID_ARGUMENT . |
VIDEO |
וידאו 360. |
XDM |
מטא-נתונים של מכשירים מורחבים, http://www.xdm.org |