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)

必要欄位。僅供輸出。更新相片時必填。僅在建立相片時輸出。相片的 ID，在 Google 的所有相片中都沒有重複。

object (UploadRef)

僅限輸入。製作相片時必填。僅限輸入。上傳相片位元組的資源網址。

string

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

string

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

string

僅供輸出。相片的分享連結。

object (Pose)

選用設定。相片的位置。

object (Connection)

選用設定。連結其他相片。連結代表這張相片與其他相片的連結。

string (Timestamp format)

選用設定。拍照的絕對時間。如果相片沒有 EXIF 時間戳記，系統會使用此參數設定相片中繼資料的時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Place)

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

string (int64 format)

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

enum (TransferStatus)

僅供輸出。這張相片的權利轉移狀態。

enum (MapsPublishStatus)

僅供輸出。Google 地圖上的狀態 (相片是否已發布或遭到拒絕)。

{
  "id": string
}

string

相片的專屬 ID。

{

  // 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

每位使用者的上傳參照都不得重複。格式如下：「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)

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

number

姿勢的高度 (以公尺為單位 WGS84 橢圓球體)。NaN 表示未測得的數量。

number

下列姿勢與相片中心相關的姿勢參數。符合 https://developers.google.com/streetview/spherical-metadata。指南針方向，從相片中心以順時針方向測量，以度為單位。值必須介於 1 至 3 之間。NaN 表示未測得的數量。

number

俯仰角：從相片中心點以度為單位。值必須介於 1=-90 且 <= 90 之間。-90 值表示直接向下觀看，90 值則代表直接向上查詢。NaN 表示未測得的數量。

number

旋轉，以度為單位。值必須介於 1 至 360 之間。0 代表與地平線的水平。NaN 表示未測得的數量。

string (Timestamp format)

GPS 記錄時間，自世界標準時間 Epoch 時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Level)

設定垂直導覽的樓層數 (一棟建築物的樓層)。

number

這個姿勢的預估水平準確度，以公尺和 68% 的信賴區間 (一個標準差) 為單位。舉例來說，在 Android 上，可透過以下方法取得這個值：https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台則使用不同的方法取得類似的準確度預估值。

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

number

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

number

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

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

number

選用設定。用於訂購的樓層號碼。0 表示地面高度，1 表示地面上第一樓，-1 表示地面下第一樓。但可接受非整數的值。

string

必要欄位。指派給這個等級的名稱，長度上限為 3 個半形字元。並思考是否有電梯時，該等級的電梯按鈕會如何加上標籤。

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

object (PhotoId)

必要欄位。內含相片與其他相片的連結目的地。

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

string

地點 ID，如 https://developers.google.com/places/place-id 所述。

string

僅供輸出。地點的名稱，且本地化為 languageCode。

string

僅供輸出。名稱本地化的 languageCode。這應該是要求中指定的 languageCode，但可以是備用語言。