Method: photoSequence.create

หลังจากที่ไคลเอ็นต์อัปโหลด PhotoSequence ด้วย UploadRef ที่ส่งคืนแล้ว photoSequence.create จะแยกลำดับภาพมุมมอง 360 จากวิดีโอหรือ Extensible Device Metadata (XDM, http://www.xdm.org/) เพื่อเผยแพร่ไปยัง Street View ใน Google Maps

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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

uploadTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างลำดับรูปภาพนี้ในบริการ uSV Store

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

rawGpsTimeline[]

object (Pose)

อินพุตเท่านั้น การวัดค่า GPS แบบข้อมูลดิบที่มีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์ที่ไม่ได้ซิงค์กับเวลากับรูปภาพแต่ละภาพ การวัดดิบเหล่านี้จะใช้ในการอนุมานท่าทางของแต่ละเฟรม ต้องใช้อินพุตเมื่อ InputType เป็น VIDEO และการวัด RAW ของ GPS ไม่อยู่ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) ผู้ใช้สามารถระบุได้ว่าสิ่งใดที่มีความสำคัญมากกว่าโดยใช้ gpsSource หากการวัดค่า GPS ดิบถูกระบุทั้งในข้อมูลดิบของ GpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM)

gpsSource

enum (GpsSource)

อินพุตเท่านั้น หากทั้ง RawGpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) มีการวัด GPS ให้ระบุว่าสิ่งใดมีความสำคัญมากกว่า

imu

object (Imu)

อินพุตเท่านั้น ข้อมูล IMU แบบ 3 แกนสำหรับคอลเล็กชัน หากข้อมูลนี้ใหญ่เกินไปที่จะส่งในคำขอ ควรใส่ไว้ในแทร็ก CAMM ของวิดีโอ ข้อมูลนี้จะมีความสำคัญเหนือกว่าข้อมูล CAMM ที่เทียบเท่าเสมอ หากมี

processingState

enum (ProcessingState)

เอาต์พุตเท่านั้น สถานะการประมวลผลของลำดับนี้

failureReason

enum (ProcessingFailureReason)

เอาต์พุตเท่านั้น หากลำดับนี้มี ProcessState = ล้มเหลว สถานะนี้จะแสดงสาเหตุที่ล้มเหลว หากกำลังประมวลผลState เป็นค่าอื่น ระบบจะยกเลิกการตั้งค่าช่องนี้

failureDetails

object (ProcessingFailureDetails)

เอาต์พุตเท่านั้น หากลำดับนี้มีการตั้งค่า failureReason ไว้ ก็อาจมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

distanceMeters

number

เอาต์พุตเท่านั้น ระยะทางที่คำนวณของลำดับรูปภาพ หน่วยเป็นเมตร

sequenceBounds

object (LatLngBounds)

เอาต์พุตเท่านั้น กล่องสี่เหลี่ยมผืนผ้าที่ครอบคลุมรูปภาพทุกรูปในลำดับรูปภาพนี้

viewCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนการดูทั้งหมดที่รูปภาพที่เผยแพร่ทั้งหมดใน PhotoSequence นี้ได้รับ

filename

string

เอาต์พุตเท่านั้น ชื่อไฟล์ของการอัปโหลด ไม่รวมเส้นทางไดเรกทอรี ใช้ได้เฉพาะเมื่ออัปโหลดลำดับบนแพลตฟอร์มที่ระบุชื่อไฟล์เท่านั้น

GpsSource

แหล่งข้อมูลหลักของการวัด GPS

Enum
PHOTO_SEQUENCE GPS ในข้อมูลดิบGpsTimeline จะมีความสำคัญเหนือกว่าหากมี
CAMERA_MOTION_METADATA_TRACK GPS ในการติดตามข้อมูลเมตาของกล้อง (CAMM) จะมีความสำคัญเหนือกว่า หากมี

Imu

ข้อมูล IMU จากเซ็นเซอร์ของอุปกรณ์

การแสดง JSON
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
ช่อง
accelMpsps[]

object (Measurement3d)

ตัวตรวจวัดความเร่งมีหน่วยเป็นเมตร/วินาที^2 โดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์

gyroRps[]

object (Measurement3d)

เครื่องวัดการหมุนจะวัดเป็นเรเดียน/วินาทีโดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์

magUt[]

object (Measurement3d)

ค่าเครื่องวัดค่าความเข้มข้นของสนามแม่เหล็กของสนามแม่เหล็กในหน่วยไมโครเทสลา (uT) โดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์

การวัด 3 มิติ

ตัวอย่างการวัด 3 มิติทั่วไป

การแสดง JSON
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
ช่อง
captureTime

string (Timestamp format)

การประทับเวลาของการวัด IMU

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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<---------+
              +------+

ลำดับอาจย้ายไปที่ 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

รายละเอียดเพิ่มเติมเพื่อใช้ร่วมกับ enumโหมดการประมวลผลFailureสาเหตุ คาดหวังว่าข้อความนี้จะใช้ร่วมกับ ProcessFailureสาเหตุ เสมอ และค่าหนึ่งค่าที่ตั้งไว้ในข้อความนี้ควรตรงกับอื่นนอกเหนือจากพื้นที่ทำงาน

การแสดง 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 ที่เกี่ยวข้องในprocessingFailureสาเหตุ details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

โปรดดู onlyGpsFailureDetails

gpsDataGapDetails

object (GpsDataGapFailureDetails)

โปรดดู GpsDataGapFailureDetails

imuDataGapDetails

object (ImuDataGapFailureDetails)

โปรดดู ImuDataGapFailureDetails

notOutdoorsDetails

object (NotOutdoorsFailureDetails)

ดู NotOutdoorsFailureDetails

noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

โปรดดู NoOverlapGpsFailureDetails

InsufficientGpsFailureDetails

รายละเอียดเกี่ยวกับProcessFailureสาเหตุ#INSUFFICIENT_GPS

การแสดง JSON
{
  "gpsPointsFound": integer
}
ช่อง
gpsPointsFound

integer

จำนวนจุด GPS ที่พบในวิดีโอ

GpsDataGapFailureDetails

รายละเอียดที่เกี่ยวข้องกับProcessFailureReason#GPS_DATA_GAP หากมีช่องว่างของข้อมูล GPS หลายจุด ระบบจะรายงานเฉพาะรายการที่มีระยะเวลามากที่สุดเท่านั้น

การแสดง JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
ช่อง
gapDuration

string (Duration format)

ระยะเวลาของช่องว่างในข้อมูล GPS ที่พบ

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

gapStartTime

string (Duration format)

เวลาที่เกี่ยวข้อง (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อเริ่มมีช่องว่าง

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

ImuDataGapFailureDetails

รายละเอียดเกี่ยวกับProcessFailureReason#IMU_DATA_GAP หากมีช่องว่างของข้อมูล IMU หลายรายการ ระบบจะรายงานเฉพาะรายการที่มีระยะเวลามากที่สุดเท่านั้น

การแสดง JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
ช่อง
gapDuration

string (Duration format)

ระยะเวลาของช่องว่างในข้อมูล IMU ที่พบ

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

gapStartTime

string (Duration format)

เวลาที่เกี่ยวข้อง (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อเริ่มมีช่องว่าง

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

NotOutdoorsFailureDetails

รายละเอียดเกี่ยวกับProcessFailureReason#NOT_OUTDOORS หากพบเฟรมในอาคารหลายเฟรม ระบบจะบันทึกเฟรมแรกที่นี่

การแสดง JSON
{
  "startTime": string
}
ช่อง
startTime

string (Duration format)

เวลาสัมพัทธ์ (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อพบเฟรมในอาคาร

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

gpsEndTime

string (Timestamp format)

เวลาของจุด GPS ที่บันทึกไว้ล่าสุด

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

videoStartTime

string (Timestamp format)

เวลาเริ่มต้นของวิดีโอ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

videoEndTime

string (Timestamp format)

เวลาสิ้นสุดของวิดีโอ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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