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ỉ xuất khi tạo ảnh. Giá trị nhận dạng của bức ảnh, là giá trị duy nhất trong số tất cả ảnh trên Google.
uploadReference

object (UploadRef)

Chỉ có đầu vào. Bắt buộc khi tạo ảnh. Chỉ có đầu vào. 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 GetPhotoRequest.view được đặt 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 bức ảnh đã cho.
pose

object (Pose)

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

object (Connection)

Không bắt buộc. Kết nối với các bức ảnh khác. Mối kết nối là đường liên kết từ bức ảnh này đến một bức ảnh khác.
captureTime

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Không bắt buộc. Những địa điểm có bức ả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 quyền đối với bức ảnh này.
mapsPublishStatus

enum (MapsPublishStatus)

Chỉ có đầu ra. Trạng thái trên 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 riêng biệt của một bức ảnh.

UploadRef

Tải tệp đối chiếu lên cho 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 nhóm file_source. Bắt buộc. file_source chỉ có thể là một trong những trạng thái sau:
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. Đường dẫn này có 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 tại đây: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Khi tạo một Photo, nếu bạn không cung cấp cặp vĩ độ và kinh độ, thì hệ thống sẽ sử dụng thông tin định vị địa lý trong tiêu đề exif. Nếu ảnh hoặc tiêu đề exif không có cặp vĩ độ và kinh độ, thì quá trình xử lý ảnh sẽ không thành công.
altitude

number

Độ cao của tư thế, tính bằng mét so với hình elip WGS84. NaN cho biết một số lượng chưa đo lường được.
heading

number

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

number

Độ nghiêng, được đo ở tâm ảnh bằng độ. Giá trị phải lớn hơn hoặc bằng -90 và nhỏ hơn hoặc bằng 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 cho biết một số lượng chưa đo lường được.
roll

number

Độ nghiêng, được đo bằng độ. Giá trị phải lớn hơn hoặc bằng 0 và nhỏ hơn 360. Giá trị 0 có nghĩa là ngang với đường chân trời. NaN cho biết một số lượng chưa đo lường đượ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 theo giờ UTC.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
level

object (Level)

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

number

Độ chính xác theo phương 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ó trong phương thức sau: https://developer.android.com/reference/android/location/Location#getAccuracy(). Các nền tảng khác có những phương thức khác để thu thập thông tin ước tính độ chính xác tương tự.

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Thông tin này được biểu thị dưới dạng một cặp số thực có độ chính xác kép để biểu thị vĩ độ và kinh độ theo độ. 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 được 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 cấp độ 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 để sắp xếp. 0 cho biết tầng trệt, 1 cho biết tầng đầu tiên phía trên tầng trệt, -1 cho biết tầng đầu tiên phía dưới tầng trệt. Các giá trị không phải số nguyên đều được chấp nhận.
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 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.

Kết nối

Mố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. Đích đến của mối kết nối từ bức ảnh chứa đến một bức ả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á theo 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à một ngôn ngữ dự phòng.

TransferStatus

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

Enum
TRANSFER_STATUS_UNKNOWN Trạng thái của yêu cầu chuyển này chưa được chỉ định.
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à bức ả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 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 bức ảnh này do được chuyển quyền.

MapsPublishStatus

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

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

delete

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

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 các byte ảnh lên.

update

 Cập nhật siêu dữ liệu của một Photo, chẳng hạn như tư thế, mối liên kết với địa điểm, các mối kết nối, v.v.