リソース: 写真
写真は、写真のメタデータとともに 360° 写真を保存するために使用されます。
JSON 表現 |
---|
{ "photoId": { object ( |
フィールド | |
---|---|
photoId |
必須。出力のみ。写真を更新する際に必要です。写真の作成時にのみ出力されます。写真の識別子。Google のすべての写真の中で一意です。 |
uploadReference |
入力のみ。写真の作成時に必須です。入力のみ。写真のバイトがアップロードされるリソース URL。 |
downloadUrl |
出力のみ。写真バイトのダウンロード URL。このフィールドは、 |
thumbnailUrl |
出力のみ。指定された写真のプレビューを表示するサムネイル URL。 |
shareLink |
出力のみ。写真の共有リンク。 |
pose |
(省略可)写真のポーズ。 |
connections[] |
(省略可)他の写真への接続。結合とは、この写真から別の写真へのリンクを表します。 |
captureTime |
(省略可)写真が撮影された絶対時間。写真の EXIF タイムスタンプがない場合、これは写真メタデータにタイムスタンプを設定するために使用されます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度で小数点以下 9 桁まで指定できます。例: |
uploadTime |
出力のみ。画像がアップロードされた時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度で小数点以下 9 桁まで指定できます。例: |
places[] |
(省略可)この写真が属する場所。 |
viewCount |
出力のみ。写真の表示回数。 |
transferStatus |
出力のみ。この写真の権利譲渡のステータス。 |
mapsPublishStatus |
出力のみ。Google マップのステータス(この写真が公開または不承認かどうか)。 |
写真 ID
Photo
の識別子。
JSON 表現 |
---|
{ "id": string } |
フィールド | |
---|---|
id |
写真の一意の識別子。 |
UploadRef
メディア ファイルのリファレンスをアップロードします。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド file_source 。必須。file_source は次のいずれかになります。 |
|
uploadUrl |
アップロード参照はユーザーごとに一意である必要があります。形式は https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference} です。 |
ポーズ
エンティティの未加工のポーズ測定。
JSON 表現 |
---|
{ "latLngPair": { object ( |
フィールド | |
---|---|
latLngPair |
ポーズの緯度と経度のペア(https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng を参照)。 |
altitude |
WGS84 楕円体の上方のポーズの高度(メートル単位)。NaN は未測定の数量を示します。 |
heading |
次のポーズ パラメータは、写真の中心に関連するものです。https://developers.google.com/streetview/spherical-metadata と一致します。コンパスの向首方向。写真の中央で、北から時計回りに計測されます。値は 0 以上 360 以下にする必要があります。NaN は未測定の数量を示します。 |
pitch |
ピッチ(写真の中央)で計測されます。値は -90 以上 90 以下にする必要があります。値が -90 の場合は直接見下することを意味します。90 の場合は直接見下することを意味します。NaN は未測定の数量を示します。 |
roll |
ロール(度単位)。値は 0 以上 360 未満にする必要があります。値が 0 の場合は、水平線に沿ったレベルを意味します。NaN は未測定の数量を示します。 |
gpsRecordTimestampUnixEpoch |
UTC エポックからの GPS レコードの時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度で小数点以下 9 桁まで指定できます。例: |
level |
垂直ナビゲーションを構成するために使用されるレベル(建物内の階)。 |
accuracyMeters |
このポーズの推定水平精度は、信頼度 68%(1 標準偏差)のメートル単位で示されます。たとえば Android の場合、この値は https://developer.android.com/reference/android/location/Location#getAccuracy() から取得できます。他のプラットフォームでも、同様の精度で推定値を取得する方法が異なります。 |
LatLng
緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に指定のない限り、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。
JSON 表現 |
---|
{ "latitude": number, "longitude": number } |
フィールド | |
---|---|
latitude |
緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。 |
longitude |
経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。 |
レベル
レベル番号とそれに対応する名前を含むレベル情報。
JSON 表現 |
---|
{ "number": number, "name": string } |
フィールド | |
---|---|
number |
(省略可)注文に使用される階数。0 は地上レベル、1 は地上より 1 階上、-1 は地上下の 1 階を表します。整数以外の値でも問題ありません。 |
name |
必須。このレベルに割り当てる名前は 3 文字以内に制限されています。エレベーターがある場合、この階のエレベーター ボタンにどのようにラベルを付けるかを検討してください。 |
接続
結合とは、元の写真から宛先の写真へのリンクです。
JSON 表現 |
---|
{
"target": {
object ( |
フィールド | |
---|---|
target |
必須。含まれている写真から別の写真への接続の宛先。 |
場所
エンティティのメタデータを配置します。
JSON 表現 |
---|
{ "placeId": string, "name": string, "languageCode": string } |
フィールド | |
---|---|
placeId |
場所 ID(https://developers.google.com/places/place-id を参照)。 |
name |
出力のみ。languageCode にローカライズされた場所の名前。 |
languageCode |
出力のみ。名前がローカライズされている 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 |
|
---|---|
|
返された UploadRef を含む写真のアップロードをクライアントが終了すると、CreatePhoto はアップロードした Photo を Google マップのストリートビューに公開します。 |
|
Photo とそのメタデータを削除します。 |
|
指定された Photo のメタデータを取得します。 |
|
アップロード セッションを作成して、写真バイトのアップロードを開始します。 |
|
ポーズ、場所の関連付け、接続など、Photo のメタデータを更新します。 |