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.

Lưu ý rằng nếu BatchDeletePhotos không thành công thì tức là các trường quan trọng sẽ bị thiếu 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ô có thể vẫn không thành công. Những lỗi này được chỉ định cho mỗi PhotoResponse.status trong BatchDeletePhotosResponse.results. Hãy xem DeletePhoto để biết các lỗi cụ thể có thể xảy ra cho 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 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.

Lưu ý rằng nếu BatchGetPhotos không thành công thì tức là các trường quan trọng sẽ bị thiếu 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ô có thể vẫn không thành công. Những lỗi này được chỉ định cho mỗi PhotoResponse.status trong BatchGetPhotosResponse.results. Hãy xem GetPhoto để biết các lỗi cụ thể có thể xảy ra cho 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 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ạo dáng, liên kết địa điểm, kết nối, v.v. Không hỗ trợ thay đổi pixel của ảnh.

Lưu ý rằng nếu BatchUpdatePhotos không thành công thì tức là các trường quan trọng sẽ bị thiếu 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ô có thể vẫn không thành công. Những lỗi này được chỉ định cho mỗi PhotoResponse.status trong BatchUpdatePhotosResponse.results. Hãy xem UpdatePhoto để biết các lỗi cụ thể có thể xảy ra cho mỗi ảnh.

Hệ thống 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 một 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 Tổng quan về OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Sau khi khách hàng tải xong ả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 đề, cao độ và cuộn trong CreateImage là thông qua siêu dữ liệu Photo toàn cảnh XMP 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 Tổng quan về OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Sau khi ứng dụng tải xong PhotoSequence lên cùng 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ề một Operation, với mã nhận dạng 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 Tổng quan về OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

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

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 Tổng quan về OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Xoá PhotoSequence và siêu dữ liệu của 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 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 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 được điền sẵn nếu có lỗi khi xử lý.
  • Operation.done = true và Operation.response được điền sẵn, có 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 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 theo thứ tự dấu thời gian CreateImageSequence 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 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.

Lưu ý: Những ảnh được tạo gần đây vẫn đang được lập chỉ mục sẽ không được trả về trong phản hồ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 Tổng quan về OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Tạo 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 Tổng quan về OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Tạo phiên tải lên để bắt đầu tải lên byte ảnh. 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 được 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ử 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 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ạo dáng, liên kết địa điểm, kết nối, v.v. Không hỗ trợ thay đổi pixel của ảnh.

Hệ thống 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 Tổng quan về OAuth 2.0.

BatchDeletePhotosRequest

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

Các trường
photo_ids[]

string

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

BatchDeletePhotosResponse

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

Các 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 liệu URL tải xuống cho các byte ảnh có được trả về hay không.
Các trường
photo_ids[]

string

Bắt buộc. Mã nhận dạng 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ó trả về URL tải xuống cho các byte ảnh trong Phản hồi của ả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 xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu bạn chưa chỉ định language_code, hệ thống sẽ sử dụng ngôn ngữ ưu tiên của người dùng cho các dịch vụ của Google.

BatchGetPhotosResponse

Phản hồi cho việc nhận hàng loạt Photos.

Các trường
results[]

PhotoResponse

Danh sách kết quả cho từng Photo được yêu cầu, theo thứ tự giống 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. Cập nhật pixel của ảnh không được hỗ trợ.

Các trường
update_photo_requests[]

UpdatePhotoRequest

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

BatchUpdatePhotosResponse

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

Các trường
results[]

PhotoResponse

Đã cập nhật danh sách kết quả cho từng Photo riêng lẻ, theo đúng thứ tự như yêu cầu.

Kết nối

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

Các trường
target

PhotoId

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

CreatePhotoRequest

Yêu cầu tạo một Photo.

Các trường
photo

Photo

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

CreatePhotoSequenceRequest

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

Các trường
photo_sequence

PhotoSequence

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

InputType

Bắt buộc. Dạng nhập của PhotoSequence.

InputType

Dạng nhập dữ liệu của PhotoSequence.

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

DeletePhotoRequest

Yêu cầu xoá Photo.

Các trường
photo_id

string

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

DeletePhotoSequenceRequest

Yêu cầu xoá PhotoSequence.

Các trường
sequence_id

string

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

GetPhotoRequest

Yêu cầu nhận một 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 liệu URL tải xuống cho các byte ảnh có được trả về hay không.
Các 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 xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu bạn chưa chỉ định language_code, hệ thống sẽ sử dụng ngôn ngữ ưu tiên của người dùng cho các dịch vụ của Google.

GetPhotoSequenceRequest

Yêu cầu nhận một PhotoSequence.

Theo mặc định

Các thông số:

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

string

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

PhotoView

Chỉ định xem có trả lại một URL tải xuống cho chuỗi ảnh trong download_url ảnh riêng lẻ trong phản hồi PhotoSequence hay không.

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

string

Không bắt buộc. Biểu thức 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 ProcessingFailureReason#GPS_DATA_GAP. Nếu có nhiều khoảng trống dữ liệu GPS thì chỉ có khoảng trống dữ liệu nào có thời lượng lớn nhất được báo cáo ở đây.

Các trường
gap_duration

Duration

Thời lượng khoảng trống 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 trống bắt đầu.

Tiếng Imu

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

Các trường
accel_mpsps[]

Measurement3d

Kết quả đo lường gia tốc kế tính bằng mét/giây^2 với dấu thời gian tăng dần trên các thiết bị.
gyro_rps[]

Measurement3d

Giá trị đ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

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

Đo lường 3d

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

Các trường
capture_time

Timestamp

Dấu thời gian của quá trình đo lường IMU.
x

float

Phép đo cảm biến trong trục x.
y

float

Phép đo cảm biến trong trục y.
z

float

Phép đo cảm biến trong trục z.

ImuDataGapFailureDetails

Thông tin chi tiết liên quan đến TransitionFailureReason#IMU_DATA_GAP. Nếu có nhiều khoảng trống dữ liệu IMU, thì chỉ có khoảng thời gian dài nhất được báo cáo ở đây.

Các trường
gap_duration

Duration

Thời lượng 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 trống bắt đầu.

InsufficientGpsFailureDetails

Thông tin chi tiết liên quan đến ProcessingFailureReason#INSUFFICIENT_GPS.

Các 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 trong toạ độ địa lý.

Các trường
southwest

LatLng

Góc phía tây nam của những 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 độ chứa số cấp và tên tương ứng.

Các trường
number

double

Không bắt buộc. Số tầng, dùng để đặt hàng. 0 biểu thị mặt đất, 1 biểu thị bề mặt đầu tiên so với mặt đất, -1 biểu thị độ cao đầu tiên so với mặt đất. Bạn có thể chấp nhận giá trị không phải số nguyên.
name

string

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

ListPhotoSequencesRequest

Yêu cầu liệt kê tất 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 của trang tiếp theo được trả về từ yêu cầu ListPhotoSequences trước đó, nếu có.
Các trường
page_size

int32

Không bắt buộc. Số lượng 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ể ít hơn pageSize nếu số lượng kết quả trùng khớp ít hơn pageSize. Hiện tại, tính năng này chưa được triển khai nhưng đang trong quá trình triển khai.
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 lọc. Ví dụ: imagery_type=SPHERICAL.

Các bộ lọc được hỗ trợ là: 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. Các 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 có ký tự thoát. Ví dụ: tên tệp_query="ví dụ của cụm từ.mp4"

ListPhotoSequencesResponse

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

Các 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 được điền sẵn nếu có lỗi khi 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.
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ó kết quả nào khác trong danh sách.

ListPhotosRequest

Yêu cầu liệt kê tất cả ảnh thuộc về 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 liệu 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ả lại.
  • pageToken là giá trị mã thông báo của 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. Hiện tại, "placeId" là tham số duy nhất được hỗ trợ.
Các trường
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 của 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 của 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 lọc. Ví dụ: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Các bộ lọc được hỗ trợ là: 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 xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu bạn chưa chỉ định language_code, hệ thống sẽ sử dụng ngôn ngữ ưu tiên của người dùng cho các dịch vụ của Google.

ListPhotosResponse

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

Các trường
photos[]

Photo

Danh sách ảnh. Trường pageSize trong yêu cầu xác định số lượng mục đượ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ó kết quả nào khác trong danh sách.

NoOverlapGpsFailureDetails

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

Các 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 điểm bắt đầu video.
video_end_time

Timestamp

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

NotOutdoorsFailureDetails

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

Các trường
start_time

Duration

Thời gian tương đối (từ lúc bắt đầu phát video trực tiếp) khi hệ thống tìm thấy khung hình trong nhà.

Ảnh

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

Các trường
photo_id

PhotoId

Bắt buộc. Chỉ có đầu ra. Bắt buộc khi cập nhật ảnh. Chỉ xuất ra khi tạo ảnh. Giá trị nhận dạng của ảnh (là mã nhận dạng 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 tải các byte ảnh 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 GetPhotoRequest.view được đặt 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 đã cho.
pose

Pose

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

Connection

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

Timestamp

Không bắt buộc. Thời điểm tuyệt đối khi ảnh được chụp. Khi ảnh không có dấu thời gian exif, thuộc tính này dùng để đặt dấu thời gian trong siêu dữ liệu của ả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 có ả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 quyền đối với ảnh này.
maps_publish_status

MapsPublishStatus

Chỉ có đầu ra. Trạng thái trên Google Maps, cho dù ả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 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 nhượng quyền.

Enum
TRANSFER_STATUS_UNKNOWN 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 tới người nhận.
REJECTED Người nhận đã từ chối yêu cầu chuyển ảnh này.
EXPIRED Quá trình 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ỷ quá trình chuyển ảnh này.
RECEIVED_VIA_TRANSFER Người nhận sở hữu ảnh này do đã chuyển quyền.

PhotoId

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

Các trường
id

string

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

PhotoResponse

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

Các trường
status

Status

Trạng thái của thao tác lấy 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.

Các 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ã hoạt động 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 với 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 nơi 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 gian bắt đầu của video. Nếu được điền sẵn vào dữ liệu đầu vào, trường này sẽ ghi đè thời gian chụp trong video hoặc tệp XDM.
upload_time

Timestamp

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

Pose

Chỉ nhập. Đo lường GPS thô với dấu thời gian tăng dần từ thiết bị mà không được đồng bộ hoá về thời gian với mỗi ảnh. Những số đo thô này sẽ được dùng để dự đoán tư thế của từng 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 thông tin nào được ưu tiên bằng gps_source nếu dữ liệu đo lường GPS thô được cung cấp trong cả RAW_gps_timeline và tính năng Theo dõi siêu dữ liệu chuyển động của máy ảnh (CAMM).
gps_source

GpsSource

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

Imu

Chỉ nhập. Dữ liệu IMU ba trục cho bộ sưu tập. Nếu dữ liệu này quá lớn để đưa vào yêu cầu, thì nó nên được đưa vào phần CAMM cho video. Dữ liệu này luôn được ưu tiên hơn 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ì chuỗi này sẽ chứa lý do khiến nó không thành công. Nếu process_state [trạng_thái_xử_lý] là bất kỳ giá trị nào khác, thì trường này sẽ không được đặt.
failure_details

ProcessingFailureDetails

Chỉ có đầu ra. Nếu trình tự này đã đặt failure_reason, thì trình tự 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 được 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 bao gồm 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 đã 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ó thể sử dụng nếu trình tự đã được tải lên trên một nền tảng có cung cấp tên tệp.

GpsSource

Nguồn chính để đo GPS.

Enum
PHOTO_SEQUENCE GPS trong Raw_gps_timeline sẽ được ưu tiên nếu có.
CAMERA_MOTION_METADATA_TRACK GPS trong Đường siêu dữ liệu chuyển động của máy ảnh (CAMM) sẽ được ưu tiên nếu có.

PhotoView

Chỉ định thành phần hiển thị nào 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 cho 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

Siêu dữ liệu về địa điểm cho một thực thể.

Các trường
place_id

string

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

string

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

string

Chỉ có đầu ra. Ngôn ngữ_mã dùng cho tên được 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ể.

Các trường
lat_lng_pair

LatLng

Cặp vĩ độ và kinh độ của tư thế này, như được giải thích tại đâ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, 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 sẽ khiến quá trình chụp ảnh không thành công.
altitude

double

Độ cao của tư thế tính bằng mét trên hình elip WGS84. NaN cho biết số lượng không đo lường được.
heading

double

Các thông số về tư thế sau đây gắn liền với trung tâm của ảnh. Các mô-đun này khớp với https://developers.google.com/streetview/spherical-metadata. Hướng la bàn, được đo ở giữa ả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 cho biết số lượng không đo lường được.
pitch

double

Cao độ, được đo ở giữa ảnh theo độ. Giá trị phải lớn hơn -90 và nhỏ hơn 90. Giá trị -90 nghĩa là nhìn thẳng xuống, còn giá trị 90 nghĩa là nhìn thẳng lên trên. NaN cho biết số lượng không đo lường đượ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à nằm ngang với đường chân trời. NaN cho biết số lượng không đo lường đượ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

Cấp (tầng 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 theo chiều ngang ước tính của tư thế này tính bằng mét với độ tin cậy 68% (một độ lệch chuẩn). Ví dụ: trên Android, giá trị này được cung cấp 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 để lấy số liệu ước tính chính xác tương tự nhau.

ProcessingFailureDetails

Thông tin bổ sung đi kèm với enum ProcessingFailureReason. Bạn phải luôn sử dụng thông báo này cùng với RuleFailureReason và giá trị một trong những giá trị được đặt trong thông báo này phải khớp với yếu tố không hợp lệ.

Các trường
Trường nhóm details. Bạn chỉ được đặt một bộ thông tin chi tiết và phải khớp với giá trị enum tương ứng trong ProcessingFailureReason. details chỉ có thể là một trong những trạng thái sau đây:
insufficient_gps_details

InsufficientGpsFailureDetails

Hãy xem tháng fullGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Hãy xem GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Xem ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Xem NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Hãy xem thông tin về NoDuplicateGpsFailureDetails.

ProcessingFailureReason

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

Enum
PROCESSING_FAILURE_REASON_UNSPECIFIED Chưa xác định lý do xảy ra lỗi, đây là giá trị mặc định.
LOW_RESOLUTION Độ phân giải khung hình video quá nhỏ.
DUPLICATE Video này đã được tải lên trước đây.
INSUFFICIENT_GPS Quá ít điểm GPS.
NO_OVERLAP_GPS Không có sự trùng lặp giữa khung thời gian của đường đ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 Không thể định vị chính xác chuỗi ảnh 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à một thời điểm trong tương lai.
GPS_DATA_GAP Dữ liệu GPS chứa một khoảng trống dài hơn 5 giây.
JUMPY_GPS Dữ liệu GPS quá thất thường nên không thể xử lý được.
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 trường này có thể thiếu các trường bắt buộc (x, y, z hoặc thời gian), có định dạng không chính xác hoặc bất kỳ vấn đề nào khác khiến hệ thống của chúng tôi không phân tích được 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 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 ở trong nhà nên 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 di chuyển như sau:

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

Trình tự có thể chuyển thành FAILED từ bất kỳ trạng thái nào. Ngoài ra, trình tự đã 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 được xử lý.
PROCESSING Trình tự này hiện đang được xử lý.
PROCESSED Trình tự đã được xử lý xong, bao gồm cả việc tinh chỉnh vị trí.
FAILED Không xử lý được trình tự. Hãy xem lý do thất bại để biết thêm thông tin.

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 các pixel của ảnh.

Các 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ạ giúp xác định các trường trên siêu dữ liệu ảnh cần cập nhật. Nếu không có siêu dữ liệu Photo cũ, siêu dữ liệu 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. Quá trình cập nhật sẽ không thành công 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 một danh sách được phân tách bằng dấu phẩy.

Các trường sau đây 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 trống thì mọi kết nối sẽ bị xoá.

UploadRef

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

Các trường
Trường nhóm 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

Tệp đối chiếu tải lên phải là duy nhất cho mỗi người dùng. Bản trình bày có dạng như sau: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"