- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- PhotoSequence
- GpsSource
- อิมู
- การวัดผล 3 มิติ
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- ลองใช้งาน
หลังจากที่ไคลเอ็นต์อัปโหลด PhotoSequence
พร้อม UploadRef
ที่ส่งกลับมาเสร็จแล้ว photoSequence.create
จะแยกลำดับภาพมุมมอง 360 ออกจากวิดีโอหรือข้อมูลเมตาของอุปกรณ์ที่ขยายได้ (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 และการวัด GPS แบบข้อมูลดิบไม่อยู่ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) ผู้ใช้สามารถระบุว่าสิ่งใดสําคัญกว่าโดยใช้ gpsSource หากมีการให้ค่าข้อมูล GPS ทั้งแบบ RawGpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) |
gpsSource |
อินพุตเท่านั้น หากทั้งข้อมูลดิบGpsTimeline และการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) มีการวัดค่า GPS ให้ระบุว่าค่าใดมีความสำคัญเหนือกว่า |
imu |
อินพุตเท่านั้น ข้อมูล IMU แบบ 3 แกนสำหรับการเก็บรวบรวม หากข้อมูลนี้มีขนาดใหญ่เกินกว่าที่จะใส่ในคำขอได้ ก็ควรใส่ไว้ในแทร็ก CAMM สำหรับวิดีโอ ข้อมูลนี้จะมีความสำคัญเหนือกว่าข้อมูล CAMM ที่เทียบเท่าเสมอ หากมีอยู่ |
processingState |
เอาต์พุตเท่านั้น สถานะการประมวลผลของลำดับนี้ |
failureReason |
เอาต์พุตเท่านั้น หากลำดับนี้มีprocessingState = FAILED จะมีสาเหตุที่ดำเนินการล้มเหลว หากprocessingState เป็นค่าอื่น ระบบจะยกเลิกการตั้งค่าช่องนี้ |
failureDetails |
เอาต์พุตเท่านั้น หากลำดับนี้ตั้งค่าไว้เป็น |
distanceMeters |
เอาต์พุตเท่านั้น ระยะทางที่คำนวณได้ของลำดับรูปภาพในหน่วยเมตร |
sequenceBounds |
เอาต์พุตเท่านั้น กล่องสี่เหลี่ยมผืนผ้าที่ห่อหุ้มทุกรูปภาพที่อยู่ในลำดับรูปภาพนี้ |
viewCount |
เอาต์พุตเท่านั้น จำนวนการดูทั้งหมดที่รูปภาพที่เผยแพร่ทั้งหมดใน PhotoSequence นี้ได้รับ |
filename |
เอาต์พุตเท่านั้น ชื่อไฟล์ของการอัปโหลด ไม่รวมเส้นทางไดเรกทอรี ใช้ได้ก็ต่อเมื่อมีการอัปโหลดลำดับบนแพลตฟอร์มที่มีชื่อไฟล์เท่านั้น |
GpsSource
แหล่งที่มาหลักของการวัด GPS
Enum | |
---|---|
PHOTO_SEQUENCE |
GPS ใน RawGpsTimeline จะมีความสําคัญเหนือกว่า หากมี |
CAMERA_MOTION_METADATA_TRACK |
GPS ในการติดตามข้อมูลเมตาการเคลื่อนไหวของกล้อง (CAMM) จะมีความสำคัญเหนือกว่า หากมี |
อิมู
ข้อมูล 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 ของ ProcessingFailureหนุน โดยปกติแล้วข้อความนี้ควรใช้ร่วมกับ ProcessingFailureที่ระบุใน
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม details จะมีการกำหนดรายละเอียดเพียงชุดเดียวและต้องตรงกับ enum ที่เกี่ยวข้องใน ProcessingFailureReason details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
insufficientGpsDetails |
ดู MonetizeGpsFailureDetails |
gpsDataGapDetails |
โปรดดู GpsDataGapFailureDetails |
imuDataGapDetails |
โปรดดู ImuDataGapFailureDetails |
notOutdoorsDetails |
ดู NotOutdoorsFailureDetails |
noOverlapGpsDetails |
ดู NoOverlapGpsFailureDetails |
InsufficientGpsFailureDetails
รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#INSUFFICIENT_GPS
การแสดง JSON |
---|
{ "gpsPointsFound": integer } |
ช่อง | |
---|---|
gpsPointsFound |
จำนวนจุด GPS ที่พบในวิดีโอ |
GpsDataGapFailureDetails
รายละเอียดที่เกี่ยวข้องกับ ProcessingFailureReason#GPS_DATA_GAP หากมีช่องว่างของข้อมูล GPS หลายจุด ระบบจะรายงานเฉพาะช่องว่างที่มีระยะเวลานานที่สุดที่นี่
การแสดง JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
ช่อง | |
---|---|
gapDuration |
ระยะเวลาของช่องว่างในข้อมูล GPS ที่พบ ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
gapStartTime |
เวลาสัมพัทธ์ (จากจุดเริ่มต้นของสตรีมวิดีโอ) เมื่อช่องว่างเริ่มขึ้น ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
ImuDataGapFailureDetails
รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#IMU_DATA_GAP หากมีช่องว่างข้อมูลของ IMU หลายรายการ ระบบจะรายงานเฉพาะช่องว่างที่มีระยะเวลามากที่สุดที่นี่
การแสดง JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
ช่อง | |
---|---|
gapDuration |
ระยะเวลาของช่องว่างในข้อมูล IMU ที่พบ ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
gapStartTime |
เวลาสัมพัทธ์ (จากจุดเริ่มต้นของสตรีมวิดีโอ) เมื่อช่องว่างเริ่มขึ้น ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
NotOutdoorsFailureDetails
รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#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 |