REST Resource: photo

資源：相片

系統會使用相片儲存 360 度相片及相片中繼資料。

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)
}
欄位
photoId

object (PhotoId)

必要欄位。僅供輸出。更新相片時必須提供。僅在建立相片時輸出。相片的 ID，在 Google 的所有相片中都不得重複。
uploadReference

object (UploadRef)

僅限輸入。建立相片時為必填欄位。僅限輸入。上傳相片位元組的資源網址。
downloadUrl

string

僅供輸出。相片位元組的下載網址。只有在 GetPhotoRequest.view 設為 PhotoView.INCLUDE_DOWNLOAD_URL 時，才會設定這個欄位。
thumbnailUrl

string

僅供輸出。顯示指定相片的縮圖網址。
pose

object (Pose)

選用設定。相片的正面。
connections[]

object (Connection)

選用設定。連線至其他相片。一個連線代表這張相片中的其他相片連結。
captureTime

string (Timestamp format)

選用設定。相片拍攝時的絕對時間。如果相片沒有 exif 時間戳記，這會用來設定相片中繼資料中的時間戳記。

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
uploadTime

string (Timestamp format)

僅供輸出。圖片上傳時間。

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
places[]

object (Place)

選用設定。這張相片所屬的地點。
viewCount

string (int64 format)

僅供輸出。相片瀏覽次數。
transferStatus

enum (TransferStatus)

僅供輸出。這張相片的擁有權轉移狀態。
mapsPublishStatus

enum (MapsPublishStatus)

僅供輸出。「Google 地圖」中的狀態，指出這張相片是否已發布或拒絕。

相片 ID

Photo 的 ID。

JSON 表示法 
{
  "id": string
}
欄位
id

string

相片的專屬 ID。

上傳

上傳媒體檔案參考資料。

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.
}
欄位
聯集欄位 file_source。必要欄位。file_source 只能是下列其中一項：
uploadUrl

string

每個使用者的上傳參考資料都不得重複。格式如下：https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}

姿勢

實體的原始姿勢測量。

JSON 表示法 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
欄位
latLngPair

object (LatLng)

姿勢的經緯度座標，詳情請參閱：https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 建立 Photo 時，如未提供經緯度座標，系統會使用 exif 標頭的地理位置資訊。相片或 exif 標頭中未提供的經緯度組合會導致相片處理失敗。
altitude

number

WGS84 橢圓體上方的姿勢 (以公尺為單位)。NaN 表示未測量的數量。
heading

number

下列 pose 參數與相片的中心有關。與 https://developers.google.com/streetview/spherical-metadata 相符。指南針方向 (以北方為順時針方向)。值必須大於 >=0 且小於 360。NaN 表示未測量的數量。
pitch

number

圓形，以度為單位，從相片中心測量。值 >=-90 和 <= 90。如果這個值為 -90，代表直接向後看，而 90 值則代表直接查詢。NaN 表示未測量的數量。
roll

number

滾動 (以度為單位)。值 >= 0 和 <360。值為 0 時，表示水平線水平。NaN 表示未測量的數量。
gpsRecordTimestampUnixEpoch

string (Timestamp format)

全球衛星定位系統記錄時間 (世界標準時間)

以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記，單位為奈及解析度，最多為九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
level

object (Level)

設定垂直導覽的樓層 (建築物的樓層)。
accuracyMeters

number

此投資的預估水平精確度，單位為 68%，信賴水準為 18 倍 (1 標準偏差)。舉例來說，在 Android 上，這個值 (透過 https://developer.android.com/reference/android/location/Location#getAccuracy()) 提供。在其他平台上，也有一種取得類似準確估算方式的方法。

LatLng

代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定，否則這個物件必須符合 WGS84 標準。此外，值必須在正規化範圍內。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數，必須介於 [-90.0, +90.0] 的範圍之間。
longitude

number

經度度數，必須介於 [-180.0, +180.0] 的範圍之間。

Level

包含樓層編號及其對應的等級資訊。

JSON 表示法 
{
  "number": number,
  "name": string
}
欄位
number

number

選用設定。用於訂購的樓層編號。0 表示地面等級，1 表示地面下第一層，-1 表示地面等級的第一層。非整數值即可。
name

string

必要欄位。指派給這個等級的名稱，長度不得超過 3 個字元。如果有電梯，請使用電梯按鈕為這種等級加上標籤。

情感交流

相片是指從來源相片連結到目標相片的連結。

JSON 表示法 
{
  "target": {
    object (PhotoId)
  }
}
欄位
target

object (PhotoId)

必要欄位。包含相片與其他相片的連線目的地。

地點

放置實體的中繼資料。

JSON 表示法 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
欄位
placeId

string

請按照 https://developers.google.com/places/place-id 所述的方式加入地點 ID。
name

string

僅供輸出。地點的名稱，翻譯成語言代碼。
languageCode

string

僅供輸出。該名稱使用的本地化 Code。這必須是要求中指定的 languageCode，但可能是備用程式碼。

傳輸狀態

權利轉移狀態。

列舉
TRANSFER_STATUS_UNKNOWN 未指定這項轉移作業的狀態。
NEVER_TRANSFERRED 這張相片從未轉移完成。
PENDING 這項相片轉移作業已開始，但接收者尚未回覆。
COMPLETED 相片轉移作業已完成，且這張相片已轉移至接收者。
REJECTED 接收者已拒絕這張相片的轉移程序。
EXPIRED 相片轉移要求已過期，因為收件者尚未採取任何行動。
CANCELLED 傳送者已取消這張相片的轉移作業。
RECEIVED_VIA_TRANSFER 相片因版權轉移程序而遭擁有。

地圖發布狀態

相片在 Google 地圖中的發布狀態。

列舉
UNSPECIFIED_MAPS_PUBLISH_STATUS 相片狀態不明。
PUBLISHED 相片已透過 Google 地圖公開發布。
REJECTED_UNKNOWN 相片因不明原因而遭拒。

方法

create

 用戶端上傳含有傳回 UploadRef 的相片後，CreatePhoto 會在 Google 地圖上將上傳的 Photo 發布至街景服務。

delete

 刪除 Photo 及其中繼資料。

get

 取得指定 Photo 的中繼資料。

startUpload

 建立上傳工作階段，開始上傳相片位元組。

update

 更新 Photo 的中繼資料，例如姿勢、地點關聯、連線等。