Method: photoSequence.create

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

‫photoSequence.create מחזירה Operation, עם מזהה PhotoSequence שמוגדר בשדה Operation.name.

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
inputType

enum (InputType)

חובה. טופס הקלט של PhotoSequence.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

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.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
rawGpsTimeline[]

object (Pose)

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

enum (GpsSource)

קלט בלבד. אם גם rawGpsTimeline וגם Camera Motion Metadata Track (CAMM)‎ מכילים מדידות GPS, צריך לציין למי מהם יש עדיפות.
imu

object (Imu)

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

enum (ProcessingState)

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

enum (ProcessingFailureReason)

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

object (ProcessingFailureDetails)

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

number

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

object (LatLngBounds)

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

string (int64 format)

פלט בלבד. מספר הצפיות הכולל שקיבלו כל התמונות שפורסמו ברצף התמונות הזה.
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)

מדידות התאוצה במטרים לשנייה בריבוע עם חותמות זמן עולות מהמכשירים.
gyroRps[]

object (Measurement3d)

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

object (Measurement3d)

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

Measurement3d

דוגמה כללית למדידה בתלת-ממד.

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

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
x

number

הערך של מדידת החיישן בציר X.
y

number

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

number

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

ProcessingState

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

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

הרצף יכול לעבור למצב FAILED מכל מצב. בנוסף, אפשר לעבד מחדש רצף מעובד בכל שלב.

טיפוסים בני מנייה (enum)
PROCESSING_STATE_UNSPECIFIED המצב לא צוין, זה ערך ברירת המחדל.
PENDING העיבוד של הרצף עדיין לא התחיל.
PROCESSING הרצף נמצא כרגע בתהליך עיבוד.
PROCESSED העיבוד של הרצף הסתיים, כולל שיפור המיקום.
FAILED העיבוד של הרצף נכשל. פרטים נוספים מופיעים ב-FailureReason.

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 אין מספיק נתונים על תנועה.
MAST_DOWN העמוד לא הורם.
CAMERA_COVERED המצלמה מכוסה.

ProcessingFailureDetails

פרטים נוספים שמתלווים ל-enum‏ ProcessingFailureReason. ההודעה הזו תמיד צריכה לשמש בשילוב עם ProcessingFailureReason, והערך oneof שמוגדר בהודעה הזו צריך להיות זהה ל-FailureReason.

ייצוג ב-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 המתאים ב-ProcessingFailureReason. הערך details יכול להיות רק אחד מהבאים:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

ראו InsufficientGpsFailureDetails.
gpsDataGapDetails

object (GpsDataGapFailureDetails)

מידע נוסף זמין במאמר בנושא GpsDataGapFailureDetails.
imuDataGapDetails

object (ImuDataGapFailureDetails)

ראו ImuDataGapFailureDetails.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

ראו NotOutdoorsFailureDetails.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

ראו NoOverlapGpsFailureDetails.

InsufficientGpsFailureDetails

פרטים שקשורים אל ProcessingFailureReason#INSUFFICIENT_GPS.

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

integer

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

GpsDataGapFailureDetails

פרטים שקשורים ל-ProcessingFailureReason#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

פרטים שקשורים ל-ProcessingFailureReason#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

פרטים שקשורים אל ProcessingFailureReason#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 המתועדת הראשונה.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
gpsEndTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
videoStartTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
videoEndTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

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