Method: photoSequence.create

אחרי שהלקוח מסיים להעלות את PhotoSequence עם ה-UploadRef שהוחזר, photoSequence.create מחלץ רצף של תמונות 360 מסרטון או ממטא-נתונים של מכשירים שניתן להרחיב (XDM, http://www.xdm.org/) כדי שיפורסמו ב-Street View במפות Google.

הפונקציה photoSequence.create מחזירה Operation, והמזהה PhotoSequence מוגדר בשדה Operation.name.

השיטה הזו מחזירה את קודי השגיאה הבאים:

בקשת HTTP

POST https://streetviewpublish.googleapis.com/v1/photoSequence

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של שאילתה

פרמטרים
inputType

enum (InputType)

חובה. צורת הקלט של PhotoSequence.

גוף הבקשה

גוף הבקשה מכיל מופע של PhotoSequence.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Operation.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

PhotoSequence

רצף של תמונות 360 עם מטא-נתונים.

ייצוג JSON
{
  "id": string,
  "photos": [
    {
      object (Photo)
    }
  ],
  "uploadReference": {
    object (UploadRef)
  },
  "captureTimeOverride": string,
  "uploadTime": string,
  "rawGpsTimeline": [
    {
      object (Pose)
    }
  ],
  "gpsSource": enum (GpsSource),
  "imu": {
    object (Imu)
  },
  "processingState": enum (ProcessingState),
  "failureReason": enum (ProcessingFailureReason),
  "failureDetails": {
    object (ProcessingFailureDetails)
  },
  "distanceMeters": number,
  "sequenceBounds": {
    object (LatLngBounds)
  },
  "viewCount": string,
  "filename": string
}
שדות
id

string

פלט בלבד. המזהה הייחודי של רצף התמונות. הוא משמש גם כמזהה פעולה ממושכת אם ההעלאה מתבצעת באופן אסינכרוני.

photos[]

object (Photo)

פלט בלבד. תמונות שחותמות הזמן שלהן הולכות וגדלות.

uploadReference

object (UploadRef)

קלט בלבד. נדרש בעת יצירת רצף תמונות. שם המשאב שאליו מועלים הבייטים של רצף התמונות (כסרטון).

captureTimeOverride

string (Timestamp format)

זה שינוי אופציונלי. הזמן האבסולוטי בתחילת הצילום של רצף התמונות. אם רצף התמונות הוא סרטון, זוהי שעת ההתחלה של הסרטון. אם השדה הזה יאוכלס בקלט, הוא מבטל את שעת הצילום בסרטון או בקובץ ה-XDM.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצר רצף התמונות הזה בשירות החנות של uSV.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

rawGpsTimeline[]

object (Pose)

קלט בלבד. מדידות GPS גולמיות עם חותמות זמן הולכות וגדלות מהמכשיר שלא מסתנכרנות עם כל תמונה. המדידות הגולמיות האלה ישמשו כדי להסיק את המיקום של כל פריים. נדרש כקלט כאשר קלטType הוא VIDEO ומדידות ה-GPS הגולמיות לא נמצאות ב'מעקב אחר מטא-נתונים של תנועת המצלמה' (CAMM). המשתמש יכול לציין איזה עדיפות מקבל עדיפות באמצעות gpsSource אם מדידות ה-GPS הגולמיות מסופקות גם ב-RAWGpsTimeline וגם ב- Camera Motion Metadata Track (CAMM).

gpsSource

enum (GpsSource)

קלט בלבד. אם גם RAWGpsTimeline וגם ה- Camera Motion Metadata Track (CAMM) מכילים מדידות GPS, מציינים איזו מהן מקבלת עדיפות.

imu

object (Imu)

קלט בלבד. נתוני IMU בשלושה צירים לאוסף. אם הנתונים גדולים מדי בשביל הבקשה, הם צריכים לעבור לטראק ה-CAMM של הסרטון. הנתונים האלה תמיד מקבלים עדיפות על פני נתוני CAMM מקבילים, אם קיימים.

processingState

enum (ProcessingState)

פלט בלבד. מצב העיבוד של הרצף הזה.

failureReason

enum (ProcessingFailureReason)

פלט בלבד. אם הערך של רצף הזה הואprocessingState = FAILED, למה הוא נכשל. אם ה-processingState הוא ערך אחר כלשהו, השדה הזה לא יהיה מוגדר.

failureDetails

object (ProcessingFailureDetails)

פלט בלבד. אם ברצף הזה מוגדרת failureReason, יכול להיות שיופיעו פרטים נוספים על הכשל.

distanceMeters

number

פלט בלבד. המרחק המחושב של רצף התמונות במטרים.

sequenceBounds

object (LatLngBounds)

פלט בלבד. תיבה מלבנית שכוללת כל תמונה ברצף התמונות הזה.

viewCount

string (int64 format)

פלט בלבד. המספר הכולל של צפיות שכל התמונות שפורסמו ב-PhotoSequence הזה קיבלו.

filename

string

פלט בלבד. שם הקובץ של התוכן שהעליתם. לא כולל את נתיב הספרייה. האפשרות הזו זמינה רק אם הרצף הועלה בפלטפורמה שמספקת את שם הקובץ.

GpsSource

המקור הראשי למדידות של GPS.

טיפוסים בני מנייה (enum)
PHOTO_SEQUENCE ה-GPS ב-RawGpsTimeline מקבל עדיפות, אם הוא קיים.
CAMERA_MOTION_METADATA_TRACK GPS ב- Camera Motion Metadata Track (CAMM) מקבל קדימות, אם הוא קיים.

Imu

נתוני IMU מחיישני המכשיר.

ייצוג JSON
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
שדות
accelMpsps[]

object (Measurement3d)

המדידות של מד התאוצה במטרים/שניות^2 עם חותמות זמן שגדלות בהתאם למכשירים.

gyroRps[]

object (Measurement3d)

המדידות של הג'ירוסקופ ברדיאנים לשנייה, עם עלייה בחותמות הזמן במכשירים.

magUt[]

object (Measurement3d)

המדידות של המגנטומטר של השדה המגנטי במיקרו-טסלה (uT) עם עלייה בחותמות הזמן של המכשירים.

מדידה3d

מדגם גנרי של מדידה בתלת-ממד.

ייצוג JSON
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
שדות
captureTime

string (Timestamp format)

חותמת הזמן של מדידת ה-IMU.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

x

number

מדידת החיישן בציר ה-X.

y

number

מדידת החיישן בציר ה-y.

z

number

מדידת החיישן בציר ה-z.

ProcessingState

מצב העיבוד של הרצף. המצבים נעים באופן הבא:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->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 can be only one of the following:
  "insufficientGpsDetails": {
    object (InsufficientGpsFailureDetails)
  },
  "gpsDataGapDetails": {
    object (GpsDataGapFailureDetails)
  },
  "imuDataGapDetails": {
    object (ImuDataGapFailureDetails)
  },
  "notOutdoorsDetails": {
    object (NotOutdoorsFailureDetails)
  },
  "noOverlapGpsDetails": {
    object (NoOverlapGpsFailureDetails)
  }
  // End of list of possible types for union field details.
}
שדות
שדה איחוד details. תוגדר רק קבוצת פרטים אחת, והיא צריכה להתאים ל-enum המתאים ב-ProcessFailureReason. details יכול להיות רק אחת מהאפשרויות הבאות:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

פרטים נוספים מופיעים כאן: InsufficientGpsFailureDetails.

gpsDataGapDetails

object (GpsDataGapFailureDetails)

פרטים נוספים זמינים ב-GpsDataGapFailureDetails.

imuDataGapDetails

object (ImuDataGapFailureDetails)

פרטים נוספים זמינים ב-ImuDataGapFailureDetails.

notOutdoorsDetails

object (NotOutdoorsFailureDetails)

פרטים נוספים זמינים ב-NotOutdoorsFailureDetails.

noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

פרטים נוספים זמינים ב-NoOverlapGpsFailureDetails.

InsufficientGpsFailureDetails

פרטים שקשורים ל-ProcessFailureReason#INSUFFICIENT_GPS.

ייצוג JSON
{
  "gpsPointsFound": integer
}
שדות
gpsPointsFound

integer

מספר נקודות ה-GPS שנמצאו בסרטון.

GpsDataGapFailureDetails

פרטים שקשורים ל-ProcessFailureReason#GPS_DATA_GAP. אם יש פערים רבים בנתוני ה-GPS, רק הפער עם משך הזמן הגדול ביותר מדווח כאן.

ייצוג JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
שדות
gapDuration

string (Duration format)

משך הפער בנתוני ה-GPS שנמצא.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

gapStartTime

string (Duration format)

הזמן היחסי (מתחילת שידור הווידאו) כשהתחלת הפער.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

ImuDataGapFailureDetails

פרטים שקשורים ל-ProcessFailureReason#IMU_DATA_GAP. אם יש מספר פערים בנתונים של ה-IMU, רק הפער עם משך הזמן הארוך ביותר מדווח כאן.

ייצוג JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
שדות
gapDuration

string (Duration format)

משך הזמן שבו נמצא הפער בנתוני ה-IMU.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

gapStartTime

string (Duration format)

הזמן היחסי (מתחילת שידור הווידאו) כשהתחלת הפער.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

NotOutdoorsFailureDetails

פרטים שקשורים ל-ProcessFailureReason#NOT_OUTDOORS. אם נמצאו כמה מסגרות בתוך מבנים, הפריים הראשון מתועד כאן.

ייצוג JSON
{
  "startTime": string
}
שדות
startTime

string (Duration format)

הזמן היחסי (מתחילת שידור הווידאו) כשנמצאה מסגרת פנימית.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

NoOverlapGpsFailureDetails

פרטים שקשורים ל-PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

ייצוג JSON
{
  "gpsStartTime": string,
  "gpsEndTime": string,
  "videoStartTime": string,
  "videoEndTime": string
}
שדות
gpsStartTime

string (Timestamp format)

זמן של נקודת ה-GPS המתועדת הראשונה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

gpsEndTime

string (Timestamp format)

השעה של נקודת ה-GPS המתועדת האחרונה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

videoStartTime

string (Timestamp format)

שעת ההתחלה של הסרטון.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

videoEndTime

string (Timestamp format)

שעת הסיום של הסרטון.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

LatLngBounds

מלבן בקואורדינטות גיאוגרפיות.

ייצוג JSON
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
שדות
southwest

object (LatLng)

הפינה הדרום-מערבית של הגבולות האלה.

northeast

object (LatLng)

הפינה הצפון-מזרחית של גבולות אלה.

InputType

צורות קלט של PhotoSequence.

טיפוסים בני מנייה (enum)
INPUT_TYPE_UNSPECIFIED לא צוין. השרת יחזיר את הערך google.rpc.Code.INVALID_ARGUMENT.
VIDEO וידאו 360.
XDM מטא-נתונים של מכשיר שניתן להרחבה, http://www.xdm.org