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)

必須。出力専用。写真を更新する場合は必須。写真の作成時にのみ出力されます。写真の識別子。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 タイムスタンプがない場合、写真のメタデータにタイムスタンプを設定するために使用されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
uploadTime

string (Timestamp format)

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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 マップのステータス（この写真が公開されたかどうか）。

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 レコードの時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
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

場所の ID（https://developers.google.com/places/place-id を参照）。
name

string

出力専用。languageCode にローカライズされた場所の名前。
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 のメタデータを更新します。