REST Resource: photo

リソース: Photo

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)

必須。出力専用。写真を更新する際に必要です。写真の作成時にのみ出力されます。Google のすべての写真の中で一意の写真の識別子。
uploadReference

object (UploadRef)

入力専用。写真を作成する際に必要です。入力専用。写真のバイトがアップロードされるリソース URL。
downloadUrl

string

出力専用。写真のバイトのダウンロード URL。このフィールドは、GetPhotoRequest.view が PhotoView.INCLUDE_DOWNLOAD_URL に設定されている場合にのみ設定されます。
thumbnailUrl

string

出力専用。指定された写真のプレビューを表示するためのサムネイル URL。
pose

object (Pose)

省略可。写真のポーズ。
connections[]

object (Connection)

省略可。他の写真への接続。接続は、この写真から別の写真へのリンクを表します。
captureTime

string (Timestamp format)

省略可。写真をキャプチャした絶対時間。写真に exif タイムスタンプがない場合、写真のメタデータにタイムスタンプを設定するために使用されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"
uploadTime

string (Timestamp format)

出力専用。画像がアップロードされた日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"
places[]

object (Place)

省略可。この写真が属する場所。
viewCount

string (int64 format)

出力専用。写真の表示回数。
transferStatus

enum (TransferStatus)

出力専用。この写真の著作権譲渡のステータス。
mapsPublishStatus

enum (MapsPublishStatus)

出力専用。Google マップでのステータス（写真が公開されたか、不承認となったか）。

PhotoId

Photo の識別子。

JSON 表現 
{
  "id": string
}
フィールド
id

string

写真の一意の識別子。

UploadRef

メディア ファイルのアップロード リファレンス。

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

次のポーズ パラメータは、写真の中心に関連しています。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)

UTC エポックからの GPS レコードの時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
level

object (Level)

垂直ナビゲーションの構成に使用されるレベル（建物の階）。
accuracyMeters

number

このポーズの推定水平精度（メートル単位、68% の信頼度（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] 内になければなりません。

レベル

レベル番号とその対応する名前を含むレベル情報。

JSON 表現 
{
  "number": number,
  "name": string
}
フィールド
number

number

省略可。注文に使用される階数。0 は地上階、1 は地上階の 1 つ上の階、-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 で説明されている場所の識別子。
name

string

出力専用。言語コードにローカライズされた場所の名前。
languageCode

string

出力専用。名前がローカライズされている languageCode。これはリクエストで指定された languageCode である必要がありますが、フォールバックの場合もあります。

TransferStatus

著作権譲渡のステータス。

列挙型
TRANSFER_STATUS_UNKNOWN この転送のステータスは指定されていません。
NEVER_TRANSFERRED この写真は転送されたことがありません。
PENDING この写真の転送は開始されましたが、受信者がまだ応答していません。
COMPLETED 写真の転送が完了し、この写真は受信者に転送されました。
REJECTED 受信者がこの写真の転送を拒否しました。
EXPIRED 受信者がアクションを起こす前に写真の転送が期限切れになった。
CANCELLED 送信者がこの写真の転送をキャンセルしました。
RECEIVED_VIA_TRANSFER 権利の譲渡により、この写真の所有権は受信者にあります。

MapsPublishStatus

Google マップでの写真の公開ステータス。

列挙型
UNSPECIFIED_MAPS_PUBLISH_STATUS 写真のステータスは不明です。
PUBLISHED 写真は Google マップを通じて一般公開されます。
REJECTED_UNKNOWN 写真が原因不明で不承認となっています。

メソッド

create

 クライアントが返された UploadRef を使用して写真のアップロードを完了すると、CreatePhoto はアップロードされた Photo を Google マップのストリートビューに公開します。

delete

 Photo とそのメタデータを削除します。

get

 指定された Photo のメタデータを取得します。

startUpload

 写真のバイトのアップロードを開始するためのアップロード セッションを作成します。

update

 Photo のメタデータ（ポーズ、場所の関連付け、接続など）を更新します。