REST Resource: photo

Tài nguyên: Ảnh

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

Biểu diễn dưới dạng JSON
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Trường
photoId

object (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.

uploadReference

object (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.

downloadUrl

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.

thumbnailUrl

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

object (Pose)

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

connections[]

object (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.

captureTime

string (Timestamp format)

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.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

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

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

places[]

object (Place)

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

viewCount

string (int64 format)

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

transferStatus

enum (TransferStatus)

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

mapsPublishStatus

enum (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.

PhotoId

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

Biểu diễn dưới dạng JSON
{
  "id": string
}
Trường
id

string

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

UploadRef

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

Biểu diễn dưới dạng JSON
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
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:
uploadUrl

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/{uploadReference}"

Tư thế

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

Biểu diễn dưới dạng JSON
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Trường
latLngPair

object (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

number

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

number

Các thông số tư thế sau đây gắ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

number

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

number

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.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

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

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

level

object (Level)

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

accuracyMeters

number

Độ 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ự.

LatLng

Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đại diện cho vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.

Biểu diễn dưới dạng JSON
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].

longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Cấp độ

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

Biểu diễn dưới dạng JSON
{
  "number": number,
  "name": string
}
Trường
number

number

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.

Kết nối

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

Biểu diễn dưới dạng JSON
{
  "target": {
    object (PhotoId)
  }
}
Trường
target

object (PhotoId)

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

Địa điểm

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

Biểu diễn dưới dạng JSON
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Trường
placeId

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á thành languageCode.

languageCode

string

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

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.

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.

Phương thức

create

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

delete

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

get

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

startUpload

Tạo một phiên tải lên để bắt đầu tải các byte ảnh lên.

update

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, mối kết nối, v.v.