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 สำหรับภาพ 360 องศาในไบต์รูปภาพ 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 ออกจากวิดีโอหรือข้อมูลเมตาของอุปกรณ์ที่ขยายได้ (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 = true และเติม Operation.error หากเกิดข้อผิดพลาดในการประมวลผล
  • Operation.done = true และ 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 ต้องรวมอยู่ในข้อมูลเมตาของภาพ ดูช่องที่ต้องกรอกได้ที่ 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

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

ช่อง
gap_duration

Duration

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

Duration

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

อิมู

ข้อมูล 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

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

ช่อง
gap_duration

Duration

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

Duration

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

InsufficientGpsFailureDetails

รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#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 = true และเติม Operation.error หากเกิดข้อผิดพลาดในการประมวลผล
  • Operation.done = true และ Operation.response มีข้อความ PhotoSequence สำหรับลำดับแต่ละลำดับ ระบบจะเติมข้อมูลเฉพาะ Id เท่านั้น
next_page_token

string

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

ListPhotosRequest

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

ตามค่าเริ่มต้น

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

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

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

PhotoView

ต้องระบุ ระบุว่าควรแสดงผล URL การดาวน์โหลดสำหรับไบต์ของรูปภาพในการตอบสนองของ Photos หรือไม่
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

รายละเอียดที่เกี่ยวข้องกับ ProcessingFailurereason#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 และการวัด 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 = FAILED จะมีเหตุผลที่ทำให้ล้มเหลว หาก Processing_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 ของ ProcessingFailureหนุน โดยปกติแล้วข้อความนี้ควรใช้ร่วมกับ ProcessingFailureที่ระบุใน

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

InsufficientGpsFailureDetails

ดู MonetizeGpsFailureDetails
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}"