REST Resource: photo

Tài nguyên: Ảnh

Ảnh 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)
}
Các trường
photoId

object (PhotoId)

Bắt buộc. Chỉ đầu ra. Bắt buộc khi cập nhật ảnh. Chỉ xuất khi tạo ảnh. Giá trị nhận dạng của ảnh 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ỉ đầ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ỉ đầu ra. URL hình thu nhỏ để hiển thị bản xem trước của ảnh đã cho.
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 các ảnh khác. Kết nối thể hiện 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, chế độ này dùng để đặt dấu thời gian trong siêu dữ liệu ảnh.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

Chỉ đầu ra. Thời gian tải hình ảnh lên.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

Không bắt buộc. Những địa điểm có ảnh này.
viewCount

string (int64 format)

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

enum (TransferStatus)

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

enum (MapsPublishStatus)

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

Mã ảnh

Giá trị nhận dạng cho Photo.

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

string

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

Tham khảo Tải lên

Tải lên tham chiếu cho các tệp phương tiệ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.
}
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 loại sau đây:
uploadUrl

string

Tham chiếu tải lên phải là duy nhất cho mỗi người dùng. Bản phát hành tuân theo biểu mẫu: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Tư thế

Đo kiểu dáng 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
}
Các trường
latLngPair

object (LatLng)

Cặp vĩ độ và kinh độ của tư thế, 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 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 trên ellipsoid WGS84. NaN biểu thị số lượng không được đo lường.
heading

number

Các thông số tư thế sau liên quan đến trung tâm ảnh. Chúng khớp với https://developers.google.com/streetview/spherical-metadata. Tiêu đề la bàn, được đo tại chính giữa ảnh theo độ theo chiều kim đồng hồ từ hướng Bắc. Giá trị phải >=0 và <360. NaN biểu thị số lượng không được đo lường.
pitch

number

Độ cao, được đo ở chính giữa ảnh theo độ. Giá trị phải >=-90 và <= 90. Giá trị -90 nghĩa là nhìn thẳng xuống và giá trị 90 nghĩa là nhìn thẳng lên trên. NaN biểu thị số lượng không được đo lường.
roll

number

Cuộn, được đo bằng độ. Giá trị phải >= 0 và <360. Giá trị 0 nghĩa là tương đương với đường chân trời. NaN biểu thị số lượng không được đo lường.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Thời gian của bản ghi GPS kể từ epoch UTC.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
level

object (Level)

Tầng (tầng trong tòa nhà) được sử dụng để định cấu hình điều hướng dọc.
accuracyMeters

number

Độ 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ó sẵn từ 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 để ước tính độ chính xác tương tự.

LatLng

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

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

number

Vĩ độ theo độ. Giá trị phải nằm trong phạm vi [-90.0, +90.0].
longitude

number

Kinh độ theo độ. Giá trị này phải nằm trong phạm vi [-180.0, +180.0].

Cấp độ

Thông tin cấp chứa số cấp và tên tương ứng của cấp.

Biểu diễn dưới dạng JSON 
{
  "number": number,
  "name": string
}
Các 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 biểu thị độ cao đầu tiên so với mặt đất, -1 biểu thị độ cao đầu tiên so với mặt đất. Giá trị không phải là số nguyên được chấp nhận.
name

string

Bắt buộc. Tên được gán cho Cấp này, giới hạn ở 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.

Sự kết nối

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

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

object (PhotoId)

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

Địa điểm

Đặt siêu dữ liệu cho một đối tượng.

Biểu diễn dưới dạng JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Các 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ỉ đầu ra. Tên của địa điểm, được bản địa hoá sang languageCode.
languageCode

string

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

Trạng thái chuyển

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

Enum
TRANSFER_STATUS_UNKNOWN Chưa chỉ đị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 Đã hoàn tất quá trình chuyển ảnh và ảnh này đã được chuyển cho 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ỷ việc 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.

Trạng thái xuất bản trên Maps

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

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Trạng thái của ảnh 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 hoàn tất việc tải ảnh lên bằng UploadRef được trả về, CreatePhoto sẽ xuất bản Photo đã tải lên Chế độ xem phố trên Google Maps.

delete

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

get

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

startUpload

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

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 liên kết, v.v.