- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- PhotoSequence
- GpsSource
- Imu
- การวัด 3 มิติ
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- ลองใช้งาน
หลังจากที่ไคลเอ็นต์อัปโหลด PhotoSequence
ด้วย UploadRef
ที่ส่งคืนแล้ว photoSequence.create
จะแยกลำดับภาพมุมมอง 360 จากวิดีโอหรือ Extensible Device Metadata (XDM, http://www.xdm.org/) เพื่อเผยแพร่ไปยัง Street View ใน Google Maps
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 "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
uploadTime |
เอาต์พุตเท่านั้น เวลาที่สร้างลำดับรูปภาพนี้ในบริการ uSV Store การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
rawGpsTimeline[] |
อินพุตเท่านั้น การวัดค่า GPS แบบข้อมูลดิบที่มีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์ที่ไม่ได้ซิงค์กับเวลากับรูปภาพแต่ละภาพ การวัดดิบเหล่านี้จะใช้ในการอนุมานท่าทางของแต่ละเฟรม ต้องใช้อินพุตเมื่อ InputType เป็น VIDEO และการวัด RAW ของ GPS ไม่อยู่ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) ผู้ใช้สามารถระบุได้ว่าสิ่งใดที่มีความสำคัญมากกว่าโดยใช้ gpsSource หากการวัดค่า GPS ดิบถูกระบุทั้งในข้อมูลดิบของ GpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) |
gpsSource |
อินพุตเท่านั้น หากทั้ง RawGpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) มีการวัด GPS ให้ระบุว่าสิ่งใดมีความสำคัญมากกว่า |
imu |
อินพุตเท่านั้น ข้อมูล IMU แบบ 3 แกนสำหรับคอลเล็กชัน หากข้อมูลนี้ใหญ่เกินไปที่จะส่งในคำขอ ควรใส่ไว้ในแทร็ก CAMM ของวิดีโอ ข้อมูลนี้จะมีความสำคัญเหนือกว่าข้อมูล CAMM ที่เทียบเท่าเสมอ หากมี |
processingState |
เอาต์พุตเท่านั้น สถานะการประมวลผลของลำดับนี้ |
failureReason |
เอาต์พุตเท่านั้น หากลำดับนี้มี ProcessState = ล้มเหลว สถานะนี้จะแสดงสาเหตุที่ล้มเหลว หากกำลังประมวลผลState เป็นค่าอื่น ระบบจะยกเลิกการตั้งค่าช่องนี้ |
failureDetails |
เอาต์พุตเท่านั้น หากลำดับนี้มีการตั้งค่า |
distanceMeters |
เอาต์พุตเท่านั้น ระยะทางที่คำนวณของลำดับรูปภาพ หน่วยเป็นเมตร |
sequenceBounds |
เอาต์พุตเท่านั้น กล่องสี่เหลี่ยมผืนผ้าที่ครอบคลุมรูปภาพทุกรูปในลำดับรูปภาพนี้ |
viewCount |
เอาต์พุตเท่านั้น จำนวนการดูทั้งหมดที่รูปภาพที่เผยแพร่ทั้งหมดใน PhotoSequence นี้ได้รับ |
filename |
เอาต์พุตเท่านั้น ชื่อไฟล์ของการอัปโหลด ไม่รวมเส้นทางไดเรกทอรี ใช้ได้เฉพาะเมื่ออัปโหลดลำดับบนแพลตฟอร์มที่ระบุชื่อไฟล์เท่านั้น |
GpsSource
แหล่งข้อมูลหลักของการวัด GPS
Enum | |
---|---|
PHOTO_SEQUENCE |
GPS ในข้อมูลดิบGpsTimeline จะมีความสำคัญเหนือกว่าหากมี |
CAMERA_MOTION_METADATA_TRACK |
GPS ในการติดตามข้อมูลเมตาของกล้อง (CAMM) จะมีความสำคัญเหนือกว่า หากมี |
Imu
ข้อมูล IMU จากเซ็นเซอร์ของอุปกรณ์
การแสดง JSON |
---|
{ "accelMpsps": [ { object ( |
ช่อง | |
---|---|
accelMpsps[] |
ตัวตรวจวัดความเร่งมีหน่วยเป็นเมตร/วินาที^2 โดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์ |
gyroRps[] |
เครื่องวัดการหมุนจะวัดเป็นเรเดียน/วินาทีโดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์ |
magUt[] |
ค่าเครื่องวัดค่าความเข้มข้นของสนามแม่เหล็กของสนามแม่เหล็กในหน่วยไมโครเทสลา (uT) โดยมีการประทับเวลาที่เพิ่มขึ้นจากอุปกรณ์ |
การวัด 3 มิติ
ตัวอย่างการวัด 3 มิติทั่วไป
การแสดง JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
ช่อง | |
---|---|
captureTime |
การประทับเวลาของการวัด IMU การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
x |
การวัดเซ็นเซอร์ในแกน x |
y |
การวัดเซ็นเซอร์ในแกน y |
z |
การวัดเซ็นเซอร์ในแกน 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 ระบบจะกำหนดรายละเอียดเพียงชุดเดียวและต้องตรงกับ enum ที่เกี่ยวข้องในprocessingFailureสาเหตุ details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
|
insufficientGpsDetails |
โปรดดู onlyGpsFailureDetails |
gpsDataGapDetails |
โปรดดู GpsDataGapFailureDetails |
imuDataGapDetails |
โปรดดู ImuDataGapFailureDetails |
notOutdoorsDetails |
ดู NotOutdoorsFailureDetails |
noOverlapGpsDetails |
โปรดดู NoOverlapGpsFailureDetails |
InsufficientGpsFailureDetails
รายละเอียดเกี่ยวกับProcessFailureสาเหตุ#INSUFFICIENT_GPS
การแสดง JSON |
---|
{ "gpsPointsFound": integer } |
ช่อง | |
---|---|
gpsPointsFound |
จำนวนจุด GPS ที่พบในวิดีโอ |
GpsDataGapFailureDetails
รายละเอียดที่เกี่ยวข้องกับProcessFailureReason#GPS_DATA_GAP หากมีช่องว่างของข้อมูล GPS หลายจุด ระบบจะรายงานเฉพาะรายการที่มีระยะเวลามากที่สุดเท่านั้น
การแสดง JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
ช่อง | |
---|---|
gapDuration |
ระยะเวลาของช่องว่างในข้อมูล GPS ที่พบ ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
gapStartTime |
เวลาที่เกี่ยวข้อง (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อเริ่มมีช่องว่าง ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
ImuDataGapFailureDetails
รายละเอียดเกี่ยวกับProcessFailureReason#IMU_DATA_GAP หากมีช่องว่างของข้อมูล IMU หลายรายการ ระบบจะรายงานเฉพาะรายการที่มีระยะเวลามากที่สุดเท่านั้น
การแสดง JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
ช่อง | |
---|---|
gapDuration |
ระยะเวลาของช่องว่างในข้อมูล IMU ที่พบ ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
gapStartTime |
เวลาที่เกี่ยวข้อง (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อเริ่มมีช่องว่าง ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
NotOutdoorsFailureDetails
รายละเอียดเกี่ยวกับProcessFailureReason#NOT_OUTDOORS หากพบเฟรมในอาคารหลายเฟรม ระบบจะบันทึกเฟรมแรกที่นี่
การแสดง JSON |
---|
{ "startTime": string } |
ช่อง | |
---|---|
startTime |
เวลาสัมพัทธ์ (ตั้งแต่จุดเริ่มต้นของสตรีมวิดีโอ) เมื่อพบเฟรมในอาคาร ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
NoOverlapGpsFailureDetails
รายละเอียดที่เกี่ยวข้องกับ PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS
การแสดง JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
ช่อง | |
---|---|
gpsStartTime |
เวลาที่จุด GPS บันทึกครั้งแรก การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
gpsEndTime |
เวลาของจุด GPS ที่บันทึกไว้ล่าสุด การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
videoStartTime |
เวลาเริ่มต้นของวิดีโอ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
videoEndTime |
เวลาสิ้นสุดของวิดีโอ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
LatLngBounds
สี่เหลี่ยมผืนผ้าในพิกัดทางภูมิศาสตร์
การแสดง JSON |
---|
{ "southwest": { object ( |
ช่อง | |
---|---|
southwest |
มุมตะวันตกเฉียงใต้ของเส้นแบ่งเหล่านี้ |
northeast |
มุมตะวันออกเฉียงเหนือของเส้นแบ่งเหล่านี้ |
InputType
รูปแบบอินพุตของ PhotoSequence
Enum | |
---|---|
INPUT_TYPE_UNSPECIFIED |
ไม่ได้ระบุ เซิร์ฟเวอร์จะส่งกลับ google.rpc.Code.INVALID_ARGUMENT |
VIDEO |
วิดีโอ 360 |
XDM |
ข้อมูลเมตาของอุปกรณ์ที่ขยายได้, http://www.xdm.org |