Package google.streetview.publish.v1

ดัชนี

StreetViewPublishService

เผยแพร่และเชื่อมต่อรูปภาพที่ผู้ใช้ส่งมาใน Street View

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

ลบรายการ Photos และข้อมูลเมตาของรายการ

โปรดทราบว่าหาก BatchDeletePhotos ล้มเหลว ช่องสำคัญจะหายไปหรือเกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ แม้ว่า BatchDeletePhotos จะสำเร็จ แต่รูปภาพแต่ละรูปในกลุ่มอาจทำงานไม่สำเร็จ ระบุความล้มเหลวเหล่านี้ไว้ใน PhotoResponse.status แต่ละรายการใน BatchDeletePhotosResponse.results ดู DeletePhoto สำหรับความล้มเหลวเฉพาะที่อาจเกิดขึ้นต่อรูปภาพ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

รับข้อมูลเมตาของกลุ่ม Photo ที่ระบุ

โปรดทราบว่าหาก BatchGetPhotos ล้มเหลว ช่องสำคัญจะหายไปหรือเกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ แม้ว่า BatchGetPhotos จะสำเร็จ แต่รูปภาพแต่ละรูปในกลุ่มอาจทำงานไม่สำเร็จ ระบุความล้มเหลวเหล่านี้ไว้ใน PhotoResponse.status แต่ละรายการใน BatchGetPhotosResponse.results ดู GetPhoto สำหรับความล้มเหลวเฉพาะที่อาจเกิดขึ้นต่อรูปภาพ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

อัปเดตข้อมูลเมตาของ Photos เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ และอื่นๆ ไม่สนับสนุนการเปลี่ยนพิกเซลของรูปภาพ

โปรดทราบว่าหาก BatchUpdatePhotos ล้มเหลว ช่องสำคัญจะหายไปหรือเกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ แม้ว่า BatchUpdatePhotos จะสำเร็จ แต่รูปภาพแต่ละรูปในกลุ่มอาจทำงานไม่สำเร็จ ระบุความล้มเหลวเหล่านี้ไว้ใน PhotoResponse.status แต่ละรายการใน BatchUpdatePhotosResponse.results ดู UpdatePhoto สำหรับความล้มเหลวเฉพาะที่อาจเกิดขึ้นต่อรูปภาพ

ใช้เฉพาะช่องที่ระบุในช่อง updateMask เท่านั้น หากไม่มี updateMask การอัปเดตจะมีผลกับทุกช่อง

จำนวนข้อความ UpdatePhotoRequest ใน BatchUpdatePhotosRequest ต้องไม่เกิน 20

หมายเหตุ: หากต้องการอัปเดต Pose.altitude คุณต้องกรอก Pose.latLngPair ด้วย มิฉะนั้นคำขอจะดำเนินการไม่สำเร็จ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

หลังจากที่ลูกค้าอัปโหลดรูปภาพที่มี UploadRef ที่ส่งกลับมาเรียบร้อยแล้ว CreatePhoto จะเผยแพร่ Photo ที่อัปโหลดลงใน Street View ใน Google Maps

ปัจจุบัน วิธีเดียวในการตั้งค่าส่วนหัว ระดับเสียง และเปลี่ยนทิศทางใน CreatePhoto คือการใช้ข้อมูลเมตาของภาพ XMP ในไบต์รูปภาพ CreatePhoto ไม่สนใจช่อง pose.heading, pose.pitch, pose.roll, pose.altitude และ pose.level ใน Pose

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • google.rpc.Code.INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง หรือหากรูปภาพที่อัปโหลดไม่ใช่ภาพมุมมอง 360
  • google.rpc.Code.NOT_FOUND หากไม่มีการอ้างอิงการอัปโหลดอยู่
  • google.rpc.Code.RESOURCE_EXHAUSTEDหากบัญชีใช้พื้นที่เก็บข้อมูลถึงขีดจำกัดแล้ว
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

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

CreatePhotoSequence จะแสดงผล Operation โดยมีการตั้งค่ารหัส PhotoSequence ในช่อง Operation.name

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

ลบ Photo และข้อมูลเมตา

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

ลบ PhotoSequence และข้อมูลเมตา

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

รับข้อมูลเมตาของ Photo ที่ระบุ

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

รับข้อมูลเมตาของ PhotoSequence ที่ระบุผ่านอินเทอร์เฟซ Operation

วิธีนี้จะแสดงการตอบกลับ 3 ประเภทต่อไปนี้

  • Operation.done = เท็จ หากการประมวลผล PhotoSequence ยังไม่เสร็จ
  • Operation.done = "จริง" และป้อนข้อมูล Operation.error หากเกิดข้อผิดพลาดในการประมวลผล
  • Operation.done = "จริง" และ Operation.response ถูกโจมตี ซึ่งมีข้อความ PhotoSequence

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

แสดง PhotoSequences ทั้งหมดของผู้ใช้โดยเรียงลำดับการประทับเวลา CreatePhotoSequence จากมากไปน้อย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

แสดง Photos ทั้งหมดของผู้ใช้

หมายเหตุ: รูปภาพที่สร้างล่าสุดซึ่งยังอยู่ระหว่างการจัดทำดัชนีจะไม่ปรากฏในการตอบกลับ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

สร้างเซสชันการอัปโหลดเพื่อเริ่มอัปโหลดข้อมูลลำดับรูปภาพ ระบบจะใช้ URL การอัปโหลดของ UploadRef ที่ส่งคืนเพื่ออัปโหลดข้อมูลสำหรับ photoSequence

หลังจากการอัปโหลดเสร็จสมบูรณ์ ระบบจะใช้ UploadRef กับ CreatePhotoSequence เพื่อสร้างรายการออบเจ็กต์ PhotoSequence

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

สร้างเซสชันการอัปโหลดเพื่อเริ่มการอัปโหลดไบต์ของรูปภาพ เมธอดจะใช้ URL การอัปโหลดของ UploadRef ที่ส่งคืนเพื่ออัปโหลดไบต์สำหรับ Photo

นอกจากข้อกำหนดด้านรูปภาพที่แสดงใน https://support.google.com/maps/answer/7012050?ref_topic=6275604 แล้ว รูปภาพต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ข้อมูลเมตา XMP ของภาพ 360 องศาต้องรวมอยู่ในข้อมูลเมตาของรูปภาพ ดูช่องที่ต้องกรอกใน https://developers.google.com/streetview/spherical-metadata
  • ขนาดพิกเซลของรูปภาพต้องเป็นไปตามข้อกำหนดด้านขนาดที่ระบุไว้ใน https://support.google.com/maps/answer/7012050?ref_topic=6275604 และรูปภาพต้องเป็นแบบเต็ม 360 ในแนวนอน

หลังจากอัปโหลดเสร็จสมบูรณ์ เมธอดจะใช้ UploadRef กับ CreatePhoto เพื่อสร้างรายการออบเจ็กต์ Photo

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

อัปเดตข้อมูลเมตาของ Photo เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ ฯลฯ ไม่สนับสนุนการเปลี่ยนพิกเซลของรูปภาพ

ใช้เฉพาะช่องที่ระบุในช่อง updateMask เท่านั้น หากไม่มี updateMask การอัปเดตจะมีผลกับทุกช่อง

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

BatchDeletePhotosRequest

คำขอลบ Photos หลายรายการ

ช่อง
photo_ids[]

string

ต้องระบุ รหัสของ Photos คำขอ HTTP GET ต้องใช้ไวยากรณ์ต่อไปนี้สำหรับพารามิเตอร์การค้นหาของ URL: photoIds=<id1>&photoIds=<id2>&...

BatchDeletePhotosResponse

ตอบสนองต่อการลบเป็นกลุ่มของ Photos อย่างน้อย 1 รายการ

ช่อง
status[]

Status

สถานะสำหรับการดำเนินการลบ Photo รายการเดียวในคำขอแบบกลุ่ม

BatchGetPhotosRequest

ขอรับ Photos อย่างน้อย 1 รายการ โดยค่าเริ่มต้น

  • ไม่แสดง URL การดาวน์โหลดสำหรับไบต์รูปภาพ

พารามิเตอร์ ได้แก่

  • view จะควบคุมการส่งคืน URL การดาวน์โหลดสำหรับไบต์รูปภาพ
ช่อง
photo_ids[]

string

ต้องระบุ รหัสของ Photos สำหรับคำขอ HTTP GET พารามิเตอร์การค้นหาของ URL ควรเป็น photoIds=<id1>&photoIds=<id2>&...
view

PhotoView

ต้องระบุ ระบุว่าควรแสดงผล URL การดาวน์โหลดสำหรับไบต์รูปภาพในการตอบกลับรูปภาพหรือไม่
language_code

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ได้ระบุ language_code ระบบจะใช้ค่ากำหนดภาษาของผู้ใช้สำหรับบริการของ Google

BatchGetPhotosResponse

การตอบสนองต่อการรับ Photos แบบกลุ่ม

ช่อง
results[]

PhotoResponse

รายการผลลัพธ์สำหรับ Photo แต่ละรายการที่ขอ ในลำดับเดียวกับคำขอใน BatchGetPhotos

BatchUpdatePhotosRequest

ขออัปเดตข้อมูลเมตาของรูปภาพ ไม่สนับสนุนการอัปเดตพิกเซลของรูปภาพ

ช่อง
update_photo_requests[]

UpdatePhotoRequest

ต้องระบุ รายชื่อ UpdatePhotoRequests

BatchUpdatePhotosResponse

การตอบสนองต่อการอัปเดตข้อมูลเมตาเป็นกลุ่มของ Photos อย่างน้อย 1 รายการ

ช่อง
results[]

PhotoResponse

รายการผลลัพธ์สำหรับ Photo แต่ละรายการได้รับการอัปเดตในลำดับเดียวกันกับคำขอ

การเชื่อมต่อ

การเชื่อมต่อคือลิงก์จากรูปภาพต้นฉบับไปยังรูปภาพปลายทาง

ช่อง
target

PhotoId

ต้องระบุ ปลายทางของการเชื่อมต่อจากรูปภาพที่มีรูปภาพไปยังรูปภาพอื่น

CreatePhotoRequest

คำขอสร้าง Photo

ช่อง
photo

Photo

ต้องระบุ รูปภาพที่จะสร้าง

CreatePhotoSequenceRequest

คำขอสร้าง PhotoSequence จากวิดีโอ

ช่อง
photo_sequence

PhotoSequence

ต้องระบุ PhotoSequenceเพื่อสร้าง
input_type

InputType

ต้องระบุ รูปแบบอินพุตของ PhotoSequence

InputType

รูปแบบอินพุตของ PhotoSequence

Enum
INPUT_TYPE_UNSPECIFIED ไม่ได้ระบุ เซิร์ฟเวอร์จะส่งกลับ google.rpc.Code.INVALID_ARGUMENT
VIDEO วิดีโอ 360
XDM ข้อมูลเมตาของอุปกรณ์ที่ขยายได้, http://www.xdm.org

DeletePhotoRequest

คำขอลบ Photo

ช่อง
photo_id

string

ต้องระบุ รหัสของ Photo

DeletePhotoSequenceRequest

คำขอลบ PhotoSequence

ช่อง
sequence_id

string

ต้องระบุ รหัสของ PhotoSequence

GetPhotoRequest

คำขอรับ Photo

โดยค่าเริ่มต้น

  • ไม่แสดง URL การดาวน์โหลดสำหรับไบต์รูปภาพ

พารามิเตอร์ ได้แก่

  • view จะควบคุมการส่งคืน URL การดาวน์โหลดสำหรับไบต์รูปภาพ
ช่อง
photo_id

string

ต้องระบุ รหัสของ Photo
view

PhotoView

ต้องระบุ ระบุว่าควรแสดงผล URL การดาวน์โหลดสำหรับไบต์รูปภาพในการตอบกลับ Photo หรือไม่
language_code

string

รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ได้ระบุ language_code ระบบจะใช้ค่ากำหนดภาษาของผู้ใช้สำหรับบริการของ Google

GetPhotoSequenceRequest

คำขอรับ PhotoSequence

โดยค่าเริ่มต้น

  • ไม่ส่งกลับ URL การดาวน์โหลดสำหรับ PhotoSequence

พารามิเตอร์ ได้แก่

  • view ควบคุมว่าจะแสดง URL การดาวน์โหลดสำหรับ PhotoSequence หรือไม่
ช่อง
sequence_id

string

ต้องระบุ รหัสของลำดับรูปภาพ
view
(deprecated)

PhotoView

ระบุว่าควรส่ง URL การดาวน์โหลดสำหรับลำดับรูปภาพใน download_url ของรูปภาพแต่ละรูปในการตอบกลับ PhotoSequence หรือไม่

หมายเหตุ: ยังไม่ได้นำมาใช้ในขณะนี้
filter

string

ไม่บังคับ นิพจน์ตัวกรอง เช่น published_status=PUBLISHED

ตัวกรองที่รองรับ ได้แก่ published_status ดูข้อมูลเพิ่มเติมได้ที่ https://google.aip.dev/160

GpsDataGapFailureDetails

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

ช่อง
gap_duration

Duration

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

Duration

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

Imu

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

ช่อง
accel_mpsps[]

Measurement3d

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

Measurement3d

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

Measurement3d

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

การวัด 3 มิติ

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

ช่อง
capture_time

Timestamp

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

float

การวัดเซ็นเซอร์ในแกน x
y

float

การวัดเซ็นเซอร์ในแกน y
z

float

การวัดเซ็นเซอร์ในแกน z

ImuDataGapFailureDetails

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

ช่อง
gap_duration

Duration

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

Duration

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

InsufficientGpsFailureDetails

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

ช่อง
gps_points_found

int32

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

LatLngBounds

สี่เหลี่ยมผืนผ้าในพิกัดทางภูมิศาสตร์

ช่อง
southwest

LatLng

มุมตะวันตกเฉียงใต้ของเส้นแบ่งเหล่านี้
northeast

LatLng

มุมตะวันออกเฉียงเหนือของเส้นแบ่งเหล่านี้

ระดับ

ข้อมูลระดับที่มีหมายเลขของระดับและชื่อที่เกี่ยวข้อง

ช่อง
number

double

ไม่บังคับ หมายเลขชั้น ใช้สั่งซื้อ 0 หมายถึงระดับพื้นดิน 1 หมายถึงระดับแรกเหนือระดับพื้นดิน -1 หมายถึงระดับพื้นดินแรก แต่สามารถใช้ค่าที่ไม่ใช่จำนวนเต็มได้
name

string

ต้องระบุ ชื่อที่กำหนดให้กับระดับนี้ จำกัดอักขระ 3 ตัว พิจารณาว่าปุ่มลิฟต์จะได้รับการติดป้ายกำกับอย่างไรสำหรับระดับนี้ หากมีลิฟต์

ListPhotoSequencesRequest

ส่งคำขอแสดงรายการลำดับรูปภาพทั้งหมดที่เป็นของผู้ใช้ที่ส่งคำขอ

พารามิเตอร์ ได้แก่

  • pageSize กำหนดจำนวนสูงสุดของลำดับรูปภาพที่จะแสดง
  • pageToken คือค่าโทเค็นหน้าถัดไปที่ส่งคืนจากคำขอ ListPhotoSequences ก่อนหน้า หากมี
ช่อง
page_size

int32

ไม่บังคับ จำนวนสูงสุดของลำดับรูปภาพที่จะแสดง pageSize ต้องไม่เป็นค่าลบ หาก pageSize เป็น 0 หรือไม่ได้ระบุ ระบบจะใช้ขนาดหน้าเริ่มต้น 100 จำนวนลำดับของรูปภาพที่แสดงในคำตอบอาจน้อยกว่า pageSize หากจำนวนรายการที่ตรงกันน้อยกว่า pageSize ซึ่งขณะนี้ยังไม่ได้นำมาใช้ แต่กำลังดำเนินการ
page_token

string

ไม่บังคับ ค่า nextPageToken ที่แสดงผลจากคำขอ ListPhotoSequences ก่อนหน้า หากมี
filter

string

ไม่บังคับ นิพจน์ตัวกรอง เช่น imagery_type=SPHERICAL

ตัวกรองที่รองรับ ได้แก่ imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, "max_capture_time_seconds" ดูข้อมูลเพิ่มเติมได้ที่ https://google.aip.dev/160 ควรส่งการค้นหาชื่อไฟล์เป็นวลีเพื่อรองรับคำและสัญลักษณ์พิเศษหลายคำด้วยการเพิ่มเครื่องหมายคำพูด เช่น filename_query="example of aphrase.mp4"

ListPhotoSequencesResponse

ตอบกลับเพื่อแสดงลำดับของรูปภาพทั้งหมดของผู้ใช้

ช่อง
photo_sequences[]

Operation

รายการลำดับรูปภาพผ่านอินเทอร์เฟซ Operation

จำนวนรายการสูงสุดที่ส่งคืนได้ขึ้นอยู่กับช่อง pageSize ในคำขอ

แต่ละรายการในลิสต์จะมีสถานะที่เป็นไปได้ 3 สถานะ

  • Operation.done = เท็จ หากการประมวลผล PhotoSequence ยังไม่เสร็จ
  • Operation.done = "จริง" และป้อนข้อมูล Operation.error หากเกิดข้อผิดพลาดในการประมวลผล
  • Operation.done = "จริง" และ Operation.response มีข้อความ PhotoSequence โดยในแต่ละลำดับ ระบบจะเติมเฉพาะ Id เท่านั้น
next_page_token

string

โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป หรือเว้นว่างไว้หากไม่มีผลลัพธ์เพิ่มเติมในรายการ

ListPhotosRequest

ส่งคำขอแสดงรูปภาพทั้งหมดที่เป็นของผู้ใช้ที่ส่งคำขอนี้

โดยค่าเริ่มต้น

  • ไม่แสดง URL การดาวน์โหลดสำหรับไบต์รูปภาพ

พารามิเตอร์ ได้แก่

  • view จะควบคุมการส่งคืน URL การดาวน์โหลดสำหรับไบต์รูปภาพ
  • pageSize กำหนดจำนวนรูปภาพสูงสุดที่จะส่งคืน
  • pageToken คือค่าโทเค็นหน้าถัดไปที่ส่งคืนจากคำขอ ListPhotos ก่อนหน้า หากมี
  • filter อนุญาตให้กรองตามพารามิเตอร์ที่ระบุ "placeId" เป็นพารามิเตอร์เดียวที่รองรับในขณะนี้
ช่อง
view

PhotoView

ต้องระบุ ระบุว่าควรส่งคืน URL การดาวน์โหลดสำหรับไบต์ของรูปภาพในการตอบกลับรูปภาพหรือไม่
page_size

int32

ไม่บังคับ จำนวนรูปภาพสูงสุดที่จะแสดง pageSize ต้องไม่เป็นค่าลบ หาก pageSize เป็น 0 หรือไม่ได้ระบุ ระบบจะใช้ขนาดหน้าเริ่มต้น 100 จำนวนรูปภาพในการตอบกลับอาจน้อยกว่า pageSize หากจำนวนรูปภาพของผู้ใช้น้อยกว่า pageSize รูป
page_token

string

ไม่บังคับ ค่า nextPageToken ที่แสดงผลจากคำขอ ListPhotos ก่อนหน้า หากมี
filter

string

ไม่บังคับ นิพจน์ตัวกรอง เช่น placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

ตัวกรองที่รองรับ ได้แก่ placeId, min_latitude, max_latitude, min_longitude, max_longitude ดูข้อมูลเพิ่มเติมได้ที่ https://google.aip.dev/160
language_code

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier หากไม่ได้ระบุ language_code ระบบจะใช้ค่ากำหนดภาษาของผู้ใช้สำหรับบริการของ Google

ListPhotosResponse

ตอบกลับเพื่อแสดงรูปภาพทั้งหมดของผู้ใช้

ช่อง
photos[]

Photo

รายการรูปภาพ ช่อง pageSize ในคำขอจะกำหนดจำนวนรายการที่ส่งคืน
next_page_token

string

โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป หรือเว้นว่างไว้หากไม่มีผลลัพธ์เพิ่มเติมในรายการ

NoOverlapGpsFailureDetails

รายละเอียดที่เกี่ยวข้องกับ PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS

ช่อง
gps_start_time

Timestamp

เวลาที่จุด GPS บันทึกครั้งแรก
gps_end_time

Timestamp

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

Timestamp

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

Timestamp

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

NotOutdoorsFailureDetails

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

ช่อง
start_time

Duration

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

รูปภาพ

รูปภาพใช้เพื่อจัดเก็บภาพมุมมอง 360 พร้อมข้อมูลเมตาของรูปภาพ

ช่อง
photo_id

PhotoId

ต้องระบุ เอาต์พุตเท่านั้น ต้องระบุเมื่ออัปเดตรูปภาพ แสดงผลเมื่อสร้างรูปภาพเท่านั้น ตัวระบุสำหรับรูปภาพ ซึ่งจะไม่ซ้ำกันกับรูปภาพทั้งหมดใน Google
upload_reference

UploadRef

อินพุตเท่านั้น ต้องระบุเมื่อสร้างรูปภาพ อินพุตเท่านั้น URL ทรัพยากรที่มีการอัปโหลดไบต์ของรูปภาพ
download_url

string

เอาต์พุตเท่านั้น URL การดาวน์โหลดสำหรับไบต์ของรูปภาพ ระบบจะตั้งค่าช่องนี้เฉพาะเมื่อตั้งค่า GetPhotoRequest.view เป็น PhotoView.INCLUDE_DOWNLOAD_URL
thumbnail_url

string

เอาต์พุตเท่านั้น URL ภาพขนาดย่อสำหรับแสดงตัวอย่างของรูปภาพ
pose

Pose

ไม่บังคับ ท่าทางของรูปภาพ
connections[]

Connection

ไม่บังคับ การเชื่อมต่อกับรูปภาพอื่นๆ เส้นเชื่อมต่อจะแสดงลิงก์จากรูปภาพนี้ไปยังรูปภาพอื่น
capture_time

Timestamp

ไม่บังคับ เวลาสัมบูรณ์ที่ถ่ายภาพ เมื่อรูปภาพไม่มีการประทับเวลา Exif ระบบจะใช้การตั้งค่าการประทับเวลาในข้อมูลเมตาของรูปภาพ
upload_time

Timestamp

เอาต์พุตเท่านั้น เวลาที่อัปโหลดรูปภาพ
places[]

Place

ไม่บังคับ สถานที่ที่มีรูปภาพนี้
view_count

int64

เอาต์พุตเท่านั้น จำนวนการดูรูปภาพ
transfer_status

TransferStatus

เอาต์พุตเท่านั้น สถานะการโอนสิทธิ์ในรูปภาพนี้
maps_publish_status

MapsPublishStatus

เอาต์พุตเท่านั้น สถานะใน Google Maps ระบุว่ารูปภาพนี้เผยแพร่หรือปฏิเสธไปแล้ว

MapsPublishStatus

สถานะการเผยแพร่ของรูปภาพใน Google Maps

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS ไม่ทราบสถานะของรูปภาพ
PUBLISHED รูปภาพได้รับการเผยแพร่ต่อสาธารณะผ่าน Google Maps
REJECTED_UNKNOWN รูปภาพถูกปฏิเสธโดยไม่ทราบสาเหตุ

TransferStatus

สถานะการโอนสิทธิ์

Enum
TRANSFER_STATUS_UNKNOWN ไม่มีการระบุสถานะของการโอนนี้
NEVER_TRANSFERRED รูปภาพนี้ไม่เคยได้รับการโอน
PENDING เริ่มการโอนรูปภาพนี้แล้ว แต่ผู้รับยังไม่ตอบกลับ
COMPLETED การโอนรูปภาพเสร็จสมบูรณ์ และระบบได้โอนรูปภาพนี้ไปยังผู้รับแล้ว
REJECTED ผู้รับปฏิเสธการโอนรูปภาพนี้
EXPIRED การโอนรูปภาพหมดอายุก่อนที่ผู้รับจะดำเนินการใดๆ
CANCELLED ผู้ส่งยกเลิกการโอนรูปภาพนี้
RECEIVED_VIA_TRANSFER ผู้รับเป็นเจ้าของรูปภาพนี้เนื่องจากมีการโอนสิทธิ์

PhotoId

ตัวระบุสำหรับ Photo

ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันสำหรับรูปภาพ

PhotoResponse

เพย์โหลดการตอบกลับสำหรับ Photo รายการเดียวในการดำเนินการแบบกลุ่ม ซึ่งรวมถึง BatchGetPhotos และ BatchUpdatePhotos

ช่อง
status

Status

สถานะสำหรับการดำเนินการเพื่อรับหรืออัปเดตรูปภาพเดียวในคำขอแบบกลุ่ม
photo

Photo

ทรัพยากร Photo หากคำขอสำเร็จ

PhotoSequence

ลำดับของภาพมุมมอง 360 พร้อมข้อมูลเมตา

ช่อง
id

string

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันสำหรับลำดับรูปภาพ และยังทำหน้าที่เป็นรหัสการดำเนินการที่ใช้เวลานานหากมีการอัปโหลดแบบไม่พร้อมกัน
photos[]

Photo

เอาต์พุตเท่านั้น รูปภาพที่มีการประทับเวลาเพิ่มขึ้น
upload_reference

UploadRef

อินพุตเท่านั้น ต้องระบุเมื่อสร้างรูปภาพต่อเนื่อง ชื่อทรัพยากรที่มีการอัปโหลดไบต์ของลำดับรูปภาพ (ในรูปแบบวิดีโอ)
capture_time_override

Timestamp

ไม่บังคับ เวลาสัมบูรณ์เมื่อเริ่มจับภาพลำดับรูปภาพ หากลำดับรูปภาพเป็นวิดีโอ นี่คือเวลาเริ่มต้นของวิดีโอ หากมีการป้อนข้อมูลในช่องนี้ ระบบจะลบล้างเวลาบันทึกในวิดีโอหรือไฟล์ XDM
upload_time

Timestamp

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

Pose

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

GpsSource

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

Imu

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

ProcessingState

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

ProcessingFailureReason

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

ProcessingFailureDetails

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

double

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

LatLngBounds

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

int64

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

string

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

GpsSource

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

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

PhotoView

ระบุมุมมองของ Photo ที่จะรวมไว้ในการตอบกลับ

Enum
BASIC การตอบกลับของเซิร์ฟเวอร์จะไม่รวม URL การดาวน์โหลดสำหรับไบต์ของรูปภาพ ค่าเริ่มต้น
INCLUDE_DOWNLOAD_URL การตอบกลับของเซิร์ฟเวอร์จะมี URL การดาวน์โหลดสำหรับไบต์ของรูปภาพ

สถานที่

วางข้อมูลเมตาสำหรับเอนทิตี

ช่อง
place_id

string

ตัวระบุสถานที่ ตามที่อธิบายไว้ใน https://developers.google.com/places/place-id
name

string

เอาต์พุตเท่านั้น ชื่อสถานที่ ซึ่งแปลเป็น language_code
language_code

string

เอาต์พุตเท่านั้น รหัส language_code ที่ใช้แปลชื่อ ซึ่งควรเป็น language_code ที่ระบุไว้ในคำขอ แต่อาจเป็นรหัสสำรอง

โพส

การวัดท่าทางดิบสำหรับเอนทิตี

ช่อง
lat_lng_pair

LatLng

คู่ละติจูดและลองจิจูดของตำแหน่งตามที่อธิบายไว้ที่นี่ https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng เมื่อสร้าง Photo หากไม่ได้ระบุคู่ละติจูดและลองจิจูด ระบบจะใช้ตำแหน่งทางภูมิศาสตร์จากส่วนหัว Exif คู่ละติจูดและลองจิจูดที่ไม่ได้ระบุไว้ในรูปภาพหรือส่วนหัว EXIF จะทำให้การประมวลผลรูปภาพล้มเหลว
altitude

double

ระดับความสูงของท่าทาง หน่วยเป็นเมตรเหนือทรงรี WGS84 NaN หมายถึงจำนวนที่ไม่ได้วัด
heading

double

พารามิเตอร์การโพสต่อไปนี้เกี่ยวข้องกับจุดกึ่งกลางของรูปภาพ โดยจะตรงกับ https://developers.google.com/streetview/spherical-metadata ทิศทางของเข็มทิศ วัดจากจุดศูนย์กลางของรูปภาพเป็นองศาตามเข็มนาฬิกาจากทิศเหนือ ค่าต้องเป็น >=0 และ <360 NaN หมายถึงจำนวนที่ไม่ได้วัด
pitch

double

ระยะห่างระหว่างกึ่งกลางของรูปภาพ หน่วยเป็นองศา ค่าต้องเป็น >=-90 และ <= 90 ค่า -90 หมายถึงมองลงไปโดยตรง ส่วนค่า 90 หมายถึงมองขึ้นข้างบน NaN หมายถึงจำนวนที่ไม่ได้วัด
roll

double

ม้วนกระดาษ หน่วยเป็นองศา ค่าต้องมากกว่าหรือเท่ากับ 0 และ<360 ค่า 0 หมายถึงระดับที่มีเส้นขอบฟ้า NaN หมายถึงจำนวนที่ไม่ได้วัด
gps_record_timestamp_unix_epoch

Timestamp

เวลาของระเบียน GPS ตั้งแต่ UTC Epoch
level

Level

ระดับ (ชั้นในอาคาร) ที่ใช้เพื่อกำหนดค่าการนำทางในแนวตั้ง
accuracy_meters

float

ความแม่นยำแนวนอนโดยประมาณของท่าทางนี้ในหน่วยเมตรที่มีความเชื่อมั่น 68% (ค่าเบี่ยงเบนมาตรฐาน 1 ค่า) เช่น ใน Android ค่านี้จะใช้ได้จากเมธอดนี้: https://developer.android.com/reference/android/location/Location#getAccuracy() แพลตฟอร์มอื่นๆ มีวิธีรับค่าประมาณความแม่นยำที่คล้ายกันต่างกัน

ProcessingFailureDetails

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

ช่อง
ช่องการรวม details ระบบจะกำหนดรายละเอียดเพียงชุดเดียวและต้องตรงกับ enum ที่เกี่ยวข้องในprocessingFailureสาเหตุ details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
insufficient_gps_details

InsufficientGpsFailureDetails

โปรดดู onlyGpsFailureDetails
gps_data_gap_details

GpsDataGapFailureDetails

โปรดดู GpsDataGapFailureDetails
imu_data_gap_details

ImuDataGapFailureDetails

โปรดดู ImuDataGapFailureDetails
not_outdoors_details

NotOutdoorsFailureDetails

ดู NotOutdoorsFailureDetails
no_overlap_gps_details

NoOverlapGpsFailureDetails

โปรดดู NoOverlapGpsFailureDetails

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 มีข้อมูลการย้ายข้อมูลไม่เพียงพอ

ProcessingState

สถานะการประมวลผลของลำดับ โดยมีการย้ายรัฐดังนี้

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

ลำดับอาจย้ายไปที่ FAILED จากสถานะใดก็ได้ นอกจากนี้ ลำดับที่ประมวลผลแล้วอาจมีการประมวลผลใหม่ได้ทุกเมื่อ

Enum
PROCESSING_STATE_UNSPECIFIED ไม่มีการระบุสถานะ ค่านี้เป็นค่าเริ่มต้น
PENDING ลำดับยังไม่เริ่มประมวลผล
PROCESSING ระบบกำลังประมวลผลลำดับ
PROCESSED ลำดับประมวลผลเสร็จแล้ว รวมถึงตำแหน่งปรับแต่ง
FAILED ประมวลผลลำดับไม่สำเร็จ ดูรายละเอียดเพิ่มเติมเบื้องหลังความล้มเหลว

UpdatePhotoRequest

คำขออัปเดตข้อมูลเมตาของ Photo ไม่สนับสนุนการอัปเดตพิกเซลของรูปภาพ

ช่อง
photo

Photo

ต้องระบุ Photo ที่มีข้อมูลเมตาใหม่
update_mask

FieldMask

ต้องระบุ มาสก์ที่ระบุช่องในข้อมูลเมตาของรูปภาพที่จะอัปเดต หากไม่พบ ระบบจะแทนที่ข้อมูลเมตา Photo เก่าทั้งหมดด้วยข้อมูลเมตา Photo ใหม่ในคำขอนี้ การอัปเดตจะล้มเหลวหากระบุช่องที่ไม่ถูกต้อง คุณระบุหลายช่องไว้ในรายการที่คั่นด้วยเครื่องหมายจุลภาคได้

ฟิลด์ต่อไปนี้ถูกต้อง

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

หมายเหตุ: เมื่อ updateMask มีช่องที่ซ้ำ ระบบจะแทนที่ค่าที่ซ้ำกันทั้งชุดด้วยเนื้อหาใหม่ ตัวอย่างเช่น หาก updateMask มี connections และ UpdatePhotoRequest.photo.connections ว่างเปล่า ระบบจะนำการเชื่อมต่อทั้งหมดออก

UploadRef

อัปโหลดข้อมูลอ้างอิงสำหรับไฟล์สื่อ

ช่อง
ช่องการรวม file_source ต้องระบุ file_source ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
upload_url

string

ข้อมูลอ้างอิงการอัปโหลดไม่ควรซ้ำกันสำหรับผู้ใช้แต่ละราย โดยมีรูปแบบดังนี้ "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"