Package google.streetview.publish.v1

Chỉ mục

StreetViewPublishService

Xuất bản và kết nối ảnh do người dùng đóng góp trên Chế độ xem đường phố.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Xoá danh sách Photos và siêu dữ liệu của chúng.

Xin lưu ý rằng nếu BatchDeletePhotos không thành công thì có nghĩa là sẽ thiếu các trường quan trọng hoặc đã xảy ra lỗi xác thực. Ngay cả khi BatchDeletePhotos thành công, các ảnh riêng lẻ trong lô vẫn có thể gặp lỗi. Những lỗi này được chỉ định trong từng PhotoResponse.status trong BatchDeletePhotosResponse.results. Hãy xem DeletePhoto để biết những lỗi cụ thể có thể xảy ra với mỗi ảnh.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Lấy siêu dữ liệu của lô Photo đã chỉ định.

Xin lưu ý rằng nếu BatchGetPhotos không thành công thì có nghĩa là sẽ thiếu các trường quan trọng hoặc đã xảy ra lỗi xác thực. Ngay cả khi BatchGetPhotos thành công, các ảnh riêng lẻ trong lô vẫn có thể gặp lỗi. Những lỗi này được chỉ định trong từng PhotoResponse.status trong BatchGetPhotosResponse.results. Hãy xem GetPhoto để biết những lỗi cụ thể có thể xảy ra với mỗi ảnh.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Cập nhật siêu dữ liệu của Photos, chẳng hạn như tư thế, liên kết địa điểm, kết nối, v.v. Không hỗ trợ thay đổi pixel của ảnh.

Xin lưu ý rằng nếu BatchUpdatePhotos không thành công thì có nghĩa là sẽ thiếu các trường quan trọng hoặc đã xảy ra lỗi xác thực. Ngay cả khi BatchUpdatePhotos thành công, các ảnh riêng lẻ trong lô vẫn có thể gặp lỗi. Những lỗi này được chỉ định trong từng PhotoResponse.status trong BatchUpdatePhotosResponse.results. Hãy xem UpdatePhoto để biết những lỗi cụ thể có thể xảy ra với mỗi ảnh.

Chỉ sử dụng các trường được chỉ định trong trường updateMask. Nếu không có updateMask, nội dung cập nhật sẽ áp dụng cho tất cả các trường.

Số lượng thông báo UpdatePhotoRequest trong BatchUpdatePhotosRequest không được vượt quá 20.

Lưu ý: Để cập nhật Pose.altitude, bạn cũng phải điền Pose.latLngPair. Nếu không, yêu cầu sẽ không thành công.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Sau khi khách hàng tải ảnh lên bằng UploadRef được trả về, CreatePhoto sẽ xuất bản Photo đã tải lên Chế độ xem đường phố trên Google Maps.

Hiện tại, cách duy nhất để đặt tiêu đề, đề cử và cuộn trong CreatePhoto là thông qua siêu dữ liệu XMP của Photos trong các byte ảnh. CreatePhotos bỏ qua các trường pose.heading, pose.pitch, pose.roll, pose.altitude và pose.level trong Pose.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Sau khi ứng dụng tải xong PhotoSequence lên với UploadRef được trả về, CreatePhotoSequence sẽ trích xuất một chuỗi ảnh 360 độ từ một video hoặc Siêu dữ liệu thiết bị có thể mở rộng (XDM, http://www.xdm.org/) để xuất bản lên Chế độ xem đường phố trên Google Maps.

CreatePhotoSequence trả về Operation, với mã PhotoSequence được đặt trong trường Operation.name.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Xoá Photo và siêu dữ liệu của nó.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Xoá PhotoSequence và siêu dữ liệu của nó.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Lấy siêu dữ liệu của Photo đã chỉ định.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Lấy siêu dữ liệu của PhotoSequence đã chỉ định thông qua giao diện Operation.

Phương thức này trả về 3 loại phản hồi sau:

  • Operation.done = false, nếu quá trình xử lý PhotoSequence chưa hoàn tất.
  • Operation.done = true và Operation.error sẽ được điền sẵn nếu có lỗi trong quá trình xử lý.
  • Operation.done = true và Operation.response được chọn để chứa thông báo PhotoSequence.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Liệt kê tất cả PhotoSequences thuộc về người dùng này theo thứ tự dấu thời gian CreatePhotoSequence giảm dần.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Liệt kê tất cả Photos thuộc về người dùng này.

Lưu ý: Hệ thống sẽ không trả về những bức ảnh mới tạo gần đây mà vẫn đang được lập chỉ mục trong câu trả lời.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Tạo một phiên tải lên để bắt đầu tải dữ liệu chuỗi ảnh lên. URL tải lên của UploadRef được trả về dùng để tải dữ liệu lên cho photoSequence.

Sau khi quá trình tải lên hoàn tất, UploadRef được dùng với CreatePhotoSequence để tạo mục nhập đối tượng PhotoSequence.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Tạo một phiên tải lên để bắt đầu tải các byte ảnh lên. Phương thức này sử dụng URL tải lên của UploadRef được trả về để tải các byte lên cho Photo.

Ngoài các yêu cầu về ảnh nêu trong https://support.google.com/maps/answer/7012050?ref_topic=6275604, ảnh phải đáp ứng các yêu cầu sau:

Sau khi quá trình tải lên hoàn tất, phương thức này sẽ sử dụng UploadRef với CreatePhoto để tạo mục nhập đối tượng Photo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Cập nhật siêu dữ liệu của Photo, chẳng hạn như tư thế, mối liên kết địa điểm, các kết nối, v.v. Không hỗ trợ thay đổi pixel của ảnh.

Chỉ sử dụng các trường được chỉ định trong trường updateMask. Nếu không có updateMask, nội dung cập nhật sẽ áp dụng cho tất cả các trường.

Phương thức này trả về các mã lỗi sau:

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

BatchDeletePhotosRequest

Yêu cầu xoá nhiều Photos.

Trường
photo_ids[]

string

Bắt buộc. Mã của Photos. Các yêu cầu HTTP GET yêu cầu cú pháp sau đây cho tham số truy vấn URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Phản hồi yêu cầu xoá hàng loạt một hoặc nhiều Photos.

Trường
status[]

Status

Trạng thái của thao tác xoá một Photo trong yêu cầu hàng loạt.

BatchGetPhotosRequest

Yêu cầu nhận một hoặc nhiều Photos. Theo mặc định

  • không trả về URL tải xuống cho các byte ảnh.

Các thông số:

  • view kiểm soát việc URL tải xuống cho các byte ảnh có được trả về hay không.
Trường
photo_ids[]

string

Bắt buộc. Mã của Photos. Đối với các yêu cầu HTTP GET, tham số truy vấn URL phải là photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Bắt buộc. Chỉ định xem có cần trả về URL tải xuống cho các byte ảnh trong Phản hồi ảnh hay không.
language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu language_code không được chỉ định, hệ thống sẽ sử dụng lựa chọn ưu tiên về ngôn ngữ của người dùng đối với các dịch vụ của Google.

BatchGetPhotosResponse

Phản hồi yêu cầu nhận hàng loạt Photos.

Trường
results[]

PhotoResponse

Danh sách kết quả cho từng Photo được yêu cầu, theo cùng thứ tự như các yêu cầu trong BatchGetPhotos.

BatchUpdatePhotosRequest

Yêu cầu cập nhật siêu dữ liệu của ảnh. Không hỗ trợ cập nhật pixel của ảnh.

Trường
update_photo_requests[]

UpdatePhotoRequest

Bắt buộc. Danh sách UpdatePhotoRequests.

BatchUpdatePhotosResponse

Phản hồi cho yêu cầu cập nhật hàng loạt siêu dữ liệu của một hoặc nhiều Photos.

Trường
results[]

PhotoResponse

Danh sách kết quả cho từng Photo được cập nhật, theo cùng thứ tự như yêu cầu.

Kết nối

Kết nối là đường liên kết từ ảnh nguồn đến ảnh đích.

Trường
target

PhotoId

Bắt buộc. Điểm đến của kết nối từ ảnh chứa ảnh với ảnh khác.

CreatePhotoRequest

Yêu cầu tạo Photo.

Trường
photo

Photo

Bắt buộc. Ảnh để tạo.

CreatePhotoSequenceRequest

Yêu cầu tạo PhotoSequence từ một video.

Trường
photo_sequence

PhotoSequence

Bắt buộc. PhotoSequence để tạo.
input_type

InputType

Bắt buộc. Phương thức nhập của PhotoSequence.

InputType

Biểu mẫu nhập dữ liệu của PhotoSequence.

Enum
INPUT_TYPE_UNSPECIFIED Chưa chỉ định. Máy chủ sẽ trả về google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video 360.
XDM Siêu dữ liệu thiết bị mở rộng, http://www.xdm.org

DeletePhotoRequest

Yêu cầu xoá Photo.

Trường
photo_id

string

Bắt buộc. Mã nhận dạng của Photo.

DeletePhotoSequenceRequest

Yêu cầu xoá PhotoSequence.

Trường
sequence_id

string

Bắt buộc. Mã nhận dạng của PhotoSequence.

GetPhotoRequest

Yêu cầu nhận Photo.

Theo mặc định

  • không trả về URL tải xuống cho các byte ảnh.

Các thông số:

  • view kiểm soát việc URL tải xuống cho các byte ảnh có được trả về hay không.
Trường
photo_id

string

Bắt buộc. Mã nhận dạng của Photo.
view

PhotoView

Bắt buộc. Chỉ định xem có trả về URL tải xuống cho các byte ảnh trong phản hồi Photo hay không.
language_code

string

Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu language_code không được chỉ định, hệ thống sẽ sử dụng lựa chọn ưu tiên về ngôn ngữ của người dùng đối với các dịch vụ của Google.

GetPhotoSequenceRequest

Yêu cầu nhận PhotoSequence.

Theo mặc định

Các thông số:

  • view kiểm soát việc URL tải xuống cho PhotoSequence có được trả về hay không.
Trường
sequence_id

string

Bắt buộc. Mã của chuỗi ảnh.
view
(deprecated)

PhotoView

Chỉ định xem có cần trả lại URL tải xuống cho chuỗi ảnh trong download_url của từng ảnh trong phản hồi PhotoSequence hay không.

Lưu ý: Hiện chưa triển khai.
filter

string

Không bắt buộc. Biểu thức bộ lọc. Ví dụ: published_status=PUBLISHED.

Các bộ lọc được hỗ trợ là: published_status. Hãy tham khảo https://google.aip.dev/160 để biết thêm thông tin.

GpsDataGapFailureDetails

Thông tin chi tiết liên quan đếnđến xử lý gặp lý do#GPS_DATA_GAP. Nếu có nhiều khoảng trống dữ liệu GPS, thì chỉ có khoảng trống có thời lượng lớn nhất được báo cáo ở đây.

Trường
gap_duration

Duration

Khoảng thời gian thiếu hụt trong dữ liệu GPS đã được tìm thấy.
gap_start_time

Duration

Thời gian tương đối (từ lúc bắt đầu luồng video) khi khoảng thời gian đó bắt đầu.

Imu

Dữ liệu IMU từ các cảm biến thiết bị.

Trường
accel_mpsps[]

Measurement3d

Các phép đo gia tốc kế tính bằng mét/giây^2 với dấu thời gian tăng dần từ các thiết bị.
gyro_rps[]

Measurement3d

Các phép đo con quay hồi chuyển tính bằng radian/giây với dấu thời gian tăng dần từ các thiết bị.
mag_ut[]

Measurement3d

Các phép đo từ kế của từ trường bằng microtesla (uT) với dấu thời gian tăng dần từ các thiết bị.

Đo lường 3d

Mẫu đo lường 3d chung.

Trường
capture_time

Timestamp

Dấu thời gian của phép đo IMU.
x

float

Kết quả đo của cảm biến trên trục x.
y

float

Kết quả đo của cảm biến trên trục y.
z

float

Kết quả đo của cảm biến trên trục z.

ImuDataGapFailureDetails

Thông tin chi tiết liên quan đến xử lý gặp lỗi#IMU_DATA_GAP. Nếu có nhiều khoảng trống dữ liệu IMU, thì chỉ có khoảng trống có thời lượng lớn nhất được báo cáo ở đây.

Trường
gap_duration

Duration

Khoảng thời gian bị thiếu hụt trong dữ liệu IMU đã được tìm thấy.
gap_start_time

Duration

Thời gian tương đối (từ lúc bắt đầu luồng video) khi khoảng thời gian đó bắt đầu.

InsufficientGpsFailureDetails

Thông tin chi tiết liên quan đếnd luôn xử lý lỗi#INSUFFICIENT_GPS.

Trường
gps_points_found

int32

Số điểm GPS được tìm thấy trong video.

LatLngBounds

Một hình chữ nhật trên các toạ độ địa lý.

Trường
southwest

LatLng

Góc Tây Nam của các ranh giới này.
northeast

LatLng

Góc đông bắc của các ranh giới này.

Cấp độ

Thông tin về cấp độ, trong đó có số cấp và tên tương ứng.

Trường
number

double

Không bắt buộc. Số tầng, dùng để đặt hàng. 0 biểu thị cao độ mặt đất, 1 cho biết cấp đầu tiên trên mặt đất, -1 cho biết cao độ đầu tiên trên mặt đất. Các giá trị không phải là số nguyên được phép sử dụng.
name

string

Bắt buộc. Tên được chỉ định cho Cấp này, giới hạn 3 ký tự. Hãy xem xét cách các nút thang máy sẽ được gắn nhãn cho tầng này nếu có thang máy.

ListPhotoSequencesRequest

Yêu cầu liệt kê tất cả các chuỗi ảnh thuộc về người dùng gửi yêu cầu.

Các thông số:

  • pageSize xác định số lượng chuỗi ảnh tối đa cần trả về.
  • pageToken là giá trị mã thông báo trang tiếp theo được trả về từ yêu cầu ListPhotoSequences trước đó (nếu có).
Trường
page_size

int32

Không bắt buộc. Số chuỗi ảnh tối đa cần trả về. pageSize không được là số âm. Nếu pageSize bằng 0 hoặc không được cung cấp thì kích thước trang mặc định là 100 sẽ được sử dụng. Số chuỗi ảnh được trả về trong phản hồi có thể nhỏ hơn pageSize nếu số kết quả trùng khớp nhỏ hơn pageSize. Tính năng này hiện chưa được triển khai nhưng đang trong quá trình thực hiện.
page_token

string

Không bắt buộc. Giá trị nextPageToken được trả về từ yêu cầu ListPhotoSequences trước đó, nếu có.
filter

string

Không bắt buộc. Biểu thức bộ lọc. Ví dụ: imagery_type=SPHERICAL.

Các bộ lọc được hỗ trợ: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, "max_capture_time_seconds. Hãy tham khảo https://google.aip.dev/160 để biết thêm thông tin. Truy vấn tên tệp phải được gửi dưới dạng Cụm từ để hỗ trợ nhiều từ và ký tự đặc biệt bằng cách thêm dấu ngoặc kép thoát. Ví dụ: filename_query="ví dụ về một cụm từ.mp4"

ListPhotoSequencesResponse

Phản hồi để liệt kê tất cả chuỗi ảnh thuộc về một người dùng.

Trường
photo_sequences[]

Operation

Danh sách chuỗi ảnh thông qua giao diện Operation.

Số lượng mục tối đa được trả về dựa trên trường pageSize trong yêu cầu.

Mỗi mục trong danh sách có thể có ba trạng thái,

  • Operation.done = false, nếu quá trình xử lý PhotoSequence chưa hoàn tất.
  • Operation.done = true và Operation.error sẽ được điền sẵn nếu có lỗi trong quá trình xử lý.
  • Operation.done = true và Operation.response chứa thông báo PhotoSequence. Trong mỗi trình tự, chỉ Id được điền sẵn.
next_page_token

string

Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không còn kết quả nào trong danh sách.

ListPhotosRequest

Yêu cầu liệt kê tất cả ảnh của người dùng gửi yêu cầu.

Theo mặc định

  • không trả về URL tải xuống cho các byte ảnh.

Các thông số:

  • view kiểm soát việc URL tải xuống cho các byte ảnh có được trả về hay không.
  • pageSize xác định số lượng ảnh tối đa cần trả về.
  • pageToken là giá trị mã thông báo trang tiếp theo được trả về từ yêu cầu ListPhotos trước đó (nếu có).
  • filter cho phép lọc theo một tham số nhất định. "placeId" là tham số duy nhất được hỗ trợ tại thời điểm này.
Trường
view

PhotoView

Bắt buộc. Chỉ định xem có cần trả về URL tải xuống cho các byte ảnh trong phản hồi Photos hay không.
page_size

int32

Không bắt buộc. Số lượng ảnh tối đa cần trả lại. pageSize không được là số âm. Nếu pageSize bằng 0 hoặc không được cung cấp thì kích thước trang mặc định là 100 sẽ được sử dụng. Số lượng ảnh được trả lại trong phản hồi có thể ít hơn pageSize nếu số lượng ảnh thuộc về người dùng ít hơn pageSize.
page_token

string

Không bắt buộc. Giá trị nextPageToken được trả về từ yêu cầu ListPhotos trước đó, nếu có.
filter

string

Không bắt buộc. Biểu thức bộ lọc. Ví dụ: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Các bộ lọc được hỗ trợ: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Hãy tham khảo https://google.aip.dev/160 để biết thêm thông tin.
language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu language_code không được chỉ định, hệ thống sẽ sử dụng lựa chọn ưu tiên về ngôn ngữ của người dùng đối với các dịch vụ của Google.

ListPhotosResponse

Phản hồi để liệt kê tất cả ảnh của một người dùng.

Trường
photos[]

Photo

Danh sách ảnh. Trường pageSize trong yêu cầu sẽ xác định số lượng mặt hàng được trả về.
next_page_token

string

Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không còn kết quả nào trong danh sách.

NoOverlapGpsFailureDetails

Thông tin chi tiết liên quan đến PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Trường
gps_start_time

Timestamp

Thời gian của điểm GPS được ghi lại đầu tiên.
gps_end_time

Timestamp

Thời gian của điểm GPS được ghi lại gần đây nhất.
video_start_time

Timestamp

Thời gian bắt đầu của video.
video_end_time

Timestamp

Thời gian kết thúc video.

NotOutdoorsFailureDetails

Thông tin chi tiết liên quan đến ProcessFailureReason#NOT_OUTDOORS. Nếu tìm thấy nhiều khung hình trong nhà, thì khung hình đầu tiên sẽ được ghi lại ở đây.

Trường
start_time

Duration

Thời gian tương đối (từ lúc bắt đầu luồng video) khi tìm thấy một khung hình trong nhà.

Ảnh

Ảnh được dùng để lưu trữ ảnh 360 độ cùng với siêu dữ liệu ảnh.

Trường
photo_id

PhotoId

Bắt buộc. Chỉ có đầu ra. Bắt buộc khi cập nhật ảnh. Chỉ có thể xuất ảnh khi tạo ảnh. Giá trị nhận dạng của ảnh. Giá trị này là duy nhất trong số tất cả ảnh trên Google.
upload_reference

UploadRef

Chỉ nhập. Bắt buộc khi tạo ảnh. Chỉ nhập. URL tài nguyên nơi các byte ảnh được tải lên.
download_url

string

Chỉ có đầu ra. URL tải xuống cho các byte ảnh. Trường này chỉ được đặt khi bạn đặt GetPhotoRequest.view thành PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

Chỉ có đầu ra. URL hình thu nhỏ để hiển thị bản xem trước của ảnh được cung cấp.
pose

Pose

Không bắt buộc. Tư thế của bức ảnh.
connections[]

Connection

Không bắt buộc. Kết nối với ảnh khác. Kết nối đại diện cho liên kết từ ảnh này đến ảnh khác.
capture_time

Timestamp

Không bắt buộc. Thời gian tuyệt đối khi ảnh được chụp. Khi ảnh không có dấu thời gian exif, tính năng này dùng để đặt dấu thời gian trong siêu dữ liệu ảnh.
upload_time

Timestamp

Chỉ có đầu ra. Thời điểm hình ảnh được tải lên.
places[]

Place

Không bắt buộc. Địa điểm chứa ảnh này.
view_count

int64

Chỉ có đầu ra. Số lượt xem ảnh.
transfer_status

TransferStatus

Chỉ có đầu ra. Trạng thái chuyển giao quyền đối với ảnh này.
maps_publish_status

MapsPublishStatus

Chỉ có đầu ra. Trạng thái trong Google Maps, cho biết ảnh này đã được xuất bản hay bị từ chối.

MapsPublishStatus

Trạng thái xuất bản của ảnh trên Google Maps.

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Ảnh này có trạng thái không xác định.
PUBLISHED Ảnh được xuất bản công khai thông qua Google Maps.
REJECTED_UNKNOWN Ảnh đã bị từ chối vì lý do không xác định.

TransferStatus

Trạng thái chuyển giao quyền.

Enum
TRANSFER_STATUS_UNKNOWN Bạn chưa xác định trạng thái của quá trình chuyển này.
NEVER_TRANSFERRED Ảnh này chưa từng được chuyển.
PENDING Quá trình chuyển ảnh này đã bắt đầu nhưng người nhận chưa phản hồi.
COMPLETED Quá trình chuyển ảnh đã hoàn tất và ảnh này đã được chuyển đến người nhận.
REJECTED Người nhận đã từ chối yêu cầu chuyển ảnh này.
EXPIRED Yêu cầu chuyển ảnh đã hết hạn trước khi người nhận thực hiện bất kỳ hành động nào.
CANCELLED Người gửi đã huỷ yêu cầu chuyển ảnh này.
RECEIVED_VIA_TRANSFER Người nhận sở hữu ảnh này do đã chuyển nhượng quyền.

PhotoId

Giá trị nhận dạng của Photo.

Trường
id

string

Giá trị nhận dạng duy nhất của một ảnh.

PhotoResponse

Tải trọng phản hồi cho một Photo trong các thao tác hàng loạt, bao gồm cả BatchGetPhotos và BatchUpdatePhotos.

Trường
status

Status

Trạng thái của thao tác để tải hoặc cập nhật một ảnh trong yêu cầu hàng loạt.
photo

Photo

Tài nguyên Photo, nếu yêu cầu thành công.

PhotoSequence

Một chuỗi ảnh 360 độ cùng với siêu dữ liệu.

Trường
id

string

Chỉ có đầu ra. Giá trị nhận dạng duy nhất của chuỗi ảnh. Mã này cũng đóng vai trò là mã thao tác chạy trong thời gian dài nếu quá trình tải lên được thực hiện không đồng bộ.
photos[]

Photo

Chỉ có đầu ra. Ảnh có dấu thời gian tăng dần.
upload_reference

UploadRef

Chỉ nhập. Bắt buộc khi tạo chuỗi ảnh. Tên tài nguyên mà các byte của chuỗi ảnh (ở dạng video) được tải lên.
capture_time_override

Timestamp

Không bắt buộc. Thời gian tuyệt đối khi chuỗi ảnh bắt đầu được chụp. Nếu chuỗi ảnh là một video, thì đây là thời điểm bắt đầu video. Nếu thông tin đầu vào được điền vào trường này, thì thời gian này sẽ ghi đè thời gian quay trong tệp video hoặc XDM.
upload_time

Timestamp

Chỉ có đầu ra. Thời gian chuỗi ảnh này được tạo trong dịch vụ Cửa hàng uSV.
raw_gps_timeline[]

Pose

Chỉ nhập. Phép đo GPS thô với dấu thời gian tăng dần từ thiết bị mà không cần đồng bộ hoá thời gian với từng ảnh. Những phép đo thô này sẽ được dùng để dự đoán vị trí của mỗi khung hình. Bắt buộc trong dữ liệu đầu vào khi InputType là VIDEO và phép đo GPS thô không có trong Theo dõi siêu dữ liệu chuyển động của máy ảnh (CAMM). Người dùng có thể cho biết dữ liệu nào sẽ được ưu tiên bằng cách sử dụng gps_source nếu phép đo GPS thô được cung cấp trong cả Raw_gps_timeline và Theo dõi siêu dữ liệu chuyển động của camera (CAMM).
gps_source

GpsSource

Chỉ nhập. Nếu cả Raw_gps_timeline và Theo dõi siêu dữ liệu chuyển động của camera (CAMM) đều chứa thông tin đo lường GPS, hãy cho biết giá trị nào sẽ được ưu tiên.
imu

Imu

Chỉ nhập. Dữ liệu IMU ba trục của bộ sưu tập. Nếu dữ liệu này quá lớn để đưa vào yêu cầu, thì dữ liệu đó nên được đưa vào kênh CAMM cho video. Dữ liệu này luôn được ưu tiên so với dữ liệu CAMM tương đương, nếu có.
processing_state

ProcessingState

Chỉ có đầu ra. Trạng thái xử lý của trình tự này.
failure_reason

ProcessingFailureReason

Chỉ có đầu ra. Nếu trình tự này có process_state = FAILED, thì mục này sẽ chứa lý do khiến trình tự không hoạt động. Nếu xử lý_trạng thái là bất kỳ giá trị nào khác, trường này sẽ không được thiết lập.
failure_details

ProcessingFailureDetails

Chỉ có đầu ra. Nếu trình tự này đã được đặt failure_reason, thì tập này có thể chứa thêm thông tin chi tiết về lỗi.
distance_meters

double

Chỉ có đầu ra. Khoảng cách đã tính toán của chuỗi ảnh tính bằng mét.
sequence_bounds

LatLngBounds

Chỉ có đầu ra. Một hộp hình chữ nhật đóng gói mọi hình ảnh trong chuỗi ảnh này.
view_count

int64

Chỉ có đầu ra. Tổng số lượt xem mà tất cả hình ảnh được xuất bản trong PhotoSequence này đã nhận được.
filename

string

Chỉ có đầu ra. Tên tệp của tệp tải lên. Không bao gồm đường dẫn thư mục. Chỉ có sẵn nếu trình tự được tải lên trên nền tảng cung cấp tên tệp.

GpsSource

Nguồn chính để đo lường GPS.

Enum
PHOTO_SEQUENCE GPS trong RAW_gps_timeline sẽ được ưu tiên nếu có.
CAMERA_MOTION_METADATA_TRACK GPS trong Theo dõi siêu dữ liệu chuyển động của camera (CAMM) sẽ được ưu tiên nếu có.

PhotoView

Chỉ định khung hiển thị của Photo để đưa vào phản hồi.

Enum
BASIC Phản hồi của máy chủ không bao gồm URL tải xuống của các byte ảnh. Giá trị mặc định.
INCLUDE_DOWNLOAD_URL Phản hồi của máy chủ bao gồm URL tải xuống cho các byte ảnh.

Địa điểm

Đặt siêu dữ liệu cho một thực thể.

Trường
place_id

string

Giá trị nhận dạng địa điểm, như mô tả trong https://developers.google.com/places/place-id.
name

string

Chỉ có đầu ra. Tên của địa điểm, được bản địa hoá sang language_code.
language_code

string

Chỉ có đầu ra. language_code tương ứng với tên đã bản địa hoá. Đây phải là language_code được chỉ định trong yêu cầu, nhưng có thể là mã dự phòng.

Tư thế

Đo lường tư thế thô cho một thực thể.

Trường
lat_lng_pair

LatLng

Cặp vĩ độ và kinh độ của tư thế, như được giải thích ở đây: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Khi tạo Photo, nếu cặp vĩ độ và kinh độ không được cung cấp thì vị trí địa lý từ tiêu đề exif sẽ được sử dụng. Cặp vĩ độ và kinh độ không được cung cấp trong tiêu đề ảnh hoặc exif khiến quá trình xử lý ảnh không thành công.
altitude

double

Cao độ của tư thế tính bằng mét so với ellipsoid WGS84. NaN biểu thị một lượng không đo được.
heading

double

Các thông số tư thế sau đây gắn liền với trung tâm của ảnh. Các định dạng này khớp với https://developers.google.com/streetview/spherical-metadata. Hướng la bàn, được đo ở tâm ảnh theo độ theo chiều kim đồng hồ từ hướng Bắc. Giá trị phải lớn hơn 0 và nhỏ hơn 360. NaN biểu thị một lượng không đo được.
pitch

double

Cao độ, được đo ở tâm ảnh theo độ. Giá trị phải lớn hơn hoặc bằng 90 và nhỏ hơn 90. Giá trị -90 có nghĩa là nhìn thẳng xuống và giá trị 90 có nghĩa là nhìn thẳng lên. NaN biểu thị một lượng không đo được.
roll

double

Cuộn, được đo bằng độ. Giá trị phải lớn hơn 0 và nhỏ hơn 360. Giá trị 0 có nghĩa là mức bằng với đường chân trời. NaN biểu thị một lượng không đo được.
gps_record_timestamp_unix_epoch

Timestamp

Thời gian của bản ghi GPS kể từ thời gian bắt đầu của hệ thống UTC.
level

Level

Tầng (sàn trong một toà nhà) dùng để định cấu hình điều hướng dọc.
accuracy_meters

float

Độ chính xác ước tính theo chiều ngang của tư thế này tính bằng mét với độ tin cậy là 68% (độ lệch chuẩn). Ví dụ: trên Android, bạn có thể dùng giá trị này qua phương thức sau: https://developer.android.com/reference/android/location/Location#getAccuracy(). Các nền tảng khác có các phương pháp khác nhau để ước tính độ chính xác tương tự.

ProcessingFailureDetails

Thông tin chi tiết bổ sung đi kèm với enumận chấm khỏi lý do vi phạm. Bạn luôn nên dùng thông báo này cùng với ProcessPendingReason và giá trị được thiết lập trong thông báo này phải khớp với ErrorReason.

Trường
Trường kết hợp details. Hệ thống sẽ chỉ thiết lập một tập hợp thông tin chi tiết và phải khớp với giá trị enum tương ứng trong trong ProcessFailureReason. details chỉ có thể là một trong những trạng thái sau đây:
insufficient_gps_details

InsufficientGpsFailureDetails

Hãy xem phần {5}GpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Hãy xem phần GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Hãy xem ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Hãy xem phần NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Hãy xem NoFullGpsFailureDetails.

ProcessingFailureReason

Những nguyên nhân có thể khiến PhotoSequence này không xử lý được.

Enum
PROCESSING_FAILURE_REASON_UNSPECIFIED Chưa xác định lý do không xử lý được, đây là giá trị mặc định.
LOW_RESOLUTION Độ phân giải của khung hình video quá nhỏ.
DUPLICATE Video này đã được tải lên trước đó.
INSUFFICIENT_GPS Quá ít điểm GPS.
NO_OVERLAP_GPS Không có sự chồng chéo giữa khung thời gian của đoạn đường theo dõi GPS và khung thời gian của video.
INVALID_GPS GPS không hợp lệ (ví dụ: tất cả các điểm GPS đều ở (0,0))
FAILED_TO_REFINE_POSITIONS Chuỗi ảnh không thể xác định chính xác vị trí trên thế giới.
TAKEDOWN Trình tự đã bị gỡ bỏ vì lý do chính sách.
CORRUPT_VIDEO Tệp video đã bị hỏng hoặc không thể giải mã.
INTERNAL Đã xảy ra lỗi vĩnh viễn trong hệ thống cơ bản.
INVALID_VIDEO_FORMAT Định dạng video không hợp lệ hoặc không được hỗ trợ.
INVALID_VIDEO_DIMENSIONS Đã tìm thấy tỷ lệ cỡ ảnh không hợp lệ.
INVALID_CAPTURE_TIME Thời gian chụp không hợp lệ. Dấu thời gian là ở trong tương lai.
GPS_DATA_GAP Dữ liệu GPS chứa khoảng trống có thời lượng lớn hơn 5 giây.
JUMPY_GPS Không thể xử lý dữ liệu GPS quá thất thường.
INVALID_IMU Dữ liệu IMU (Gia tốc kế, Con quay hồi chuyển, v.v.) không hợp lệ. Các tham số này có thể thiếu các trường bắt buộc (x, y, z hoặc thời gian), có thể không được định dạng chính xác hoặc bất kỳ vấn đề nào khác ngăn hệ thống của chúng tôi phân tích cú pháp.
INSUFFICIENT_IMU Quá ít điểm IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Không đủ trùng lặp trong khung thời gian giữa GPS, IMU và dữ liệu chuỗi thời gian khác.
IMU_DATA_GAP Dữ liệu IMU (Gia tốc kế, Con quay hồi chuyển, v.v.) chứa các khoảng trống có thời lượng lớn hơn 0,1 giây.
UNSUPPORTED_CAMERA Máy ảnh không được hỗ trợ.
NOT_OUTDOORS Một số khung hình là ở trong nhà và không được hỗ trợ.
INSUFFICIENT_VIDEO_FRAMES Không đủ khung hình video.
INSUFFICIENT_MOVEMENT Không đủ dữ liệu di chuyển.

ProcessingState

Trạng thái xử lý của trình tự. Các trạng thái thay đổi như sau:

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

Trình tự có thể chuyển sang trạng thái FAILED từ bất kỳ trạng thái nào. Ngoài ra, trình tự đã được xử lý có thể được xử lý lại bất cứ lúc nào.

Enum
PROCESSING_STATE_UNSPECIFIED Trạng thái chưa được chỉ định, đây là giá trị mặc định.
PENDING Trình tự chưa bắt đầu xử lý.
PROCESSING Trình tự hiện đang được xử lý.
PROCESSED Trình tự đã hoàn tất quá trình xử lý, bao gồm cả việc tinh chỉnh vị trí.
FAILED Không thể xử lý trình tự. Vui lòng xem lỗi miễn phí để biết thêm thông tin chi tiết.

UpdatePhotoRequest

Yêu cầu cập nhật siêu dữ liệu của Photo. Không hỗ trợ cập nhật pixel của ảnh.

Trường
photo

Photo

Bắt buộc. Đối tượng Photo chứa siêu dữ liệu mới.
update_mask

FieldMask

Bắt buộc. Mặt nạ xác định các trường trong siêu dữ liệu ảnh cần cập nhật. Nếu không có, siêu dữ liệu Photo cũ sẽ được thay thế hoàn toàn bằng siêu dữ liệu Photo mới trong yêu cầu này. Không cập nhật được nếu bạn chỉ định các trường không hợp lệ. Bạn có thể chỉ định nhiều trường trong danh sách được phân tách bằng dấu phẩy.

Sau đây là các trường hợp lệ:

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

Lưu ý: Khi updateMask chứa các trường lặp lại, toàn bộ tập hợp giá trị lặp lại sẽ được thay thế bằng nội dung mới. Ví dụ: nếu updateMask chứa connections và UpdatePhotoRequest.photo.connections là trống thì mọi kết nối đều bị xoá.

UploadRef

Tải tệp tham chiếu lên cho các tệp nội dung nghe nhìn.

Trường
Trường kết hợp file_source. Bắt buộc. file_source chỉ có thể là một trong những trạng thái sau đây:
upload_url

string

Mỗi người dùng phải có một tệp đối chiếu tải lên riêng biệt. URL này có định dạng: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"