Method: photoSequence.create

หลังจากที่ไคลเอ็นต์อัปโหลด PhotoSequence พร้อม UploadRef ที่ส่งกลับมาเสร็จแล้ว photoSequence.create จะแยกลำดับภาพมุมมอง 360 ออกจากวิดีโอหรือข้อมูลเมตาของอุปกรณ์ที่ขยายได้ (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 และการวัด GPS แบบข้อมูลดิบไม่อยู่ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) ผู้ใช้สามารถระบุว่าสิ่งใดสําคัญกว่าโดยใช้ gpsSource หากมีการให้ค่าข้อมูล GPS ทั้งแบบ RawGpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM)
gpsSource

enum (GpsSource)

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

object (Imu)

อินพุตเท่านั้น ข้อมูล IMU แบบ 3 แกนสำหรับการเก็บรวบรวม หากข้อมูลนี้มีขนาดใหญ่เกินกว่าที่จะใส่ในคำขอได้ ก็ควรใส่ไว้ในแทร็ก 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 ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) จะมีความสำคัญเหนือกว่า หากมี

อิมู

ข้อมูล 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 ของ ProcessingFailureหนุน โดยปกติแล้วข้อความนี้ควรใช้ร่วมกับ ProcessingFailureที่ระบุใน

การแสดง 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)

ดู MonetizeGpsFailureDetails
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 ที่พบ

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

string (Duration format)

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

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

ImuDataGapFailureDetails

รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#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

รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#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