REST Resource: photo

{
  "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)
}

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.

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.

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.

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.

string

Chỉ có đầu ra. Đường liên kết chia sẻ ảnh.

object (Pose)

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

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.

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" và "2014-10-02T15:01:23.045123456Z".

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" và "2014-10-02T15:01:23.045123456Z".

object (Place)

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

string (int64 format)

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

enum (TransferStatus)

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

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.

{
  "id": string
}

string

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

{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}

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}"

{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}

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.

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.

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.

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.

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.

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" và "2014-10-02T15:01:23.045123456Z".

object (Level)

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

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "number": number,
  "name": string
}

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.

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.

{
  "target": {
    object (PhotoId)
  }
}

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.

{
  "placeId": string,
  "name": string,
  "languageCode": string
}

string

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

string

Chỉ có đầu ra. Tên của địa điểm, được bản địa hoá thành 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.