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 マップのステータス（この写真が公開または不承認かどうか）。

写真 ID

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 なんらかの理由で写真が拒否されました。

Methods

create

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

delete

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

get

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

startUpload

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

update

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