Package google.streetview.publish.v1

インデックス

StreetViewPublishService

ユーザーが投稿した写真をストリートビューに公開し、関連付けます。

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Photos とそのメタデータのリストを削除します。

BatchDeletePhotos が失敗した場合は、重要なフィールドがないか認証エラーになります。BatchDeletePhotos が成功した場合でも、バッチ内の個々の写真がエラーになることがあります。これらのエラーは、BatchDeletePhotosResponse.results の各 PhotoResponse.status で指定されます。写真ごとに発生する可能性のあるエラーについては、DeletePhoto をご覧ください。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

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

BatchGetPhotos が失敗した場合は、重要なフィールドがないか認証エラーになります。BatchGetPhotos が成功した場合でも、バッチ内の個々の写真がエラーになることがあります。これらのエラーは、BatchGetPhotosResponse.results の各 PhotoResponse.status で指定されます。写真ごとに発生する可能性のあるエラーについては、GetPhoto をご覧ください。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

ポーズ、場所の関連付け、接続など、Photos のメタデータを更新します。写真のピクセルの変更はサポートされていません。

BatchUpdatePhotos が失敗した場合は、重要なフィールドがないか認証エラーになります。BatchUpdatePhotos が成功した場合でも、バッチ内の個々の写真がエラーになることがあります。これらのエラーは、BatchUpdatePhotosResponse.results の各 PhotoResponse.status で指定されます。写真ごとに発生する可能性のあるエラーについては、UpdatePhoto をご覧ください。

updateMask フィールドで指定されたフィールドのみが使用されます。updateMask が存在しない場合、更新はすべてのフィールドに適用されます。

BatchUpdatePhotosRequest 内の UpdatePhotoRequest メッセージの数は 20 以下にする必要があります。

注: Pose.altitude を更新するには、Pose.latLngPair も入力する必要があります。一致していないと、リクエストは失敗します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

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

現在、CreatePhoto で見出し、ピッチ、ロールを設定する唯一の方法は、写真バイトの 360°写真(XMP)メタデータを使用することです。CreatePhoto は、ポーズの pose.headingpose.pitchpose.rollpose.altitudepose.level フィールドを無視します。

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

クライアントが返された UploadRef を含む PhotoSequence のアップロードを完了すると、CreatePhotoSequence は動画または拡張デバイス メタデータ(XDM、http://www.xdm.org/)から一連の 360° 写真を抽出して、Google マップのストリートビューに公開します。

CreatePhotoSequence は、Operation.name フィールドに PhotoSequence ID を設定して Operation を返します。

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

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

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

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

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

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

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Operation インターフェース経由で、指定された PhotoSequence のメタデータを取得します。

このメソッドは、次の 3 種類のレスポンスを返します。

  • Operation.done = false(PhotoSequence の処理がまだ終了していない場合)。
  • Operation.done = true。処理中にエラーが発生した場合、Operation.error が入力されます。
  • Operation.done = true。Operation.response がポーリングされ、PhotoSequence メッセージが含まれます。

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

ユーザーに属するすべての PhotoSequences を CreatePhotoSequence タイムスタンプの降順で一覧表示します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

ユーザーに属するすべての Photos を一覧表示します。

注: 最近作成され、まだインデックスに登録されている写真はレスポンスで返されません。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

アップロード セッションを作成し、写真シーケンス データのアップロードを開始します。返された UploadRef のアップロード URL を使用して、photoSequence のデータをアップロードします。

アップロードが完了すると、UploadRefCreatePhotoSequence とともに使用され、PhotoSequence オブジェクト エントリが作成されます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

アップロード セッションを作成して、写真バイトのアップロードを開始します。このメソッドは、返された UploadRef のアップロード URL を使用して、Photo のバイトをアップロードします。

https://support.google.com/maps/answer/7012050?ref_topic=6275604 に記載されている写真の要件に加えて、写真は以下の要件を満たしている必要があります。

アップロードの完了後、メソッドは UploadRefCreatePhoto を使用して、Photo オブジェクト エントリを作成します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

ポーズ、場所の関連付け、接続など、Photo のメタデータを更新します。写真のピクセルの変更はサポートされていません。

updateMask フィールドで指定されたフィールドのみが使用されます。updateMask が存在しない場合、更新はすべてのフィールドに適用されます。

このメソッドは以下のエラーコードを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/streetviewpublish

詳しくは、OAuth 2.0 の概要をご覧ください。

BatchDeletePhotosRequest

複数の Photos の削除をリクエストします。

フィールド
photo_ids[]

string

必須。Photos の ID。HTTP GET リクエストでは、URL クエリ パラメータの構文として photoIds=<id1>&photoIds=<id2>&... を指定する必要があります。

BatchDeletePhotosResponse

1 つ以上の Photos の一括削除に対するレスポンス。

フィールド
status[]

Status

バッチ リクエストで 1 つの Photo を削除するオペレーションのステータス。

BatchGetPhotosRequest

1 つ以上の Photos を取得するリクエスト。デフォルト

  • は写真バイトのダウンロード URL を返しません。

パラメータ:

  • view は、写真バイトのダウンロード URL を返すかどうかを制御します。
フィールド
photo_ids[]

string

必須。Photos の ID。HTTP GET リクエストの場合、URL クエリ パラメータは photoIds=<id1>&photoIds=<id2>&... にする必要があります。

view

PhotoView

必須。写真のレスポンスで写真バイトのダウンロード URL を返すかどうかを指定します。

language_code

string

省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。language_code を指定しない場合、Google サービスのユーザーの言語設定が使用されます。

BatchGetPhotosResponse

Photos のバッチ取得に対するレスポンス。

フィールド
results[]

PhotoResponse

リクエストされた個々の Photo の結果のリスト。BatchGetPhotos のリクエストと同じ順序で並べられます。

BatchUpdatePhotosRequest

写真のメタデータの更新をリクエストします。写真のピクセルの更新はサポートされていません。

フィールド
update_photo_requests[]

UpdatePhotoRequest

必須。UpdatePhotoRequests のリスト。

BatchUpdatePhotosResponse

1 つ以上の Photos のメタデータのバッチ更新に対するレスポンス。

フィールド
results[]

PhotoResponse

個々の Photo の結果のリストを、リクエストと同じ順序で更新しました。

接続

結合とは、元の写真から移動先の写真へのリンクのことです。

フィールド
target

PhotoId

必須。含まれている写真から別の写真への接続先。

CreatePhotoRequest

Photo の作成をリクエストします。

フィールド
photo

Photo

必須。作成する写真です。

CreatePhotoSequenceRequest

動画から PhotoSequence を作成するためのリクエスト。

フィールド
photo_sequence

PhotoSequence

必須。作成する PhotoSequence

input_type

InputType

必須。PhotoSequence の入力形式。

InputType

PhotoSequence の入力形式。

列挙型
INPUT_TYPE_UNSPECIFIED 指定なし。サーバーは google.rpc.Code.INVALID_ARGUMENT を返します。
VIDEO 360° 動画。
XDM Extensible Device Metadata、http://www.xdm.org

DeletePhotoRequest

Photo の削除をリクエストします。

フィールド
photo_id

string

必須。Photo の ID。

DeletePhotoSequenceRequest

PhotoSequence の削除をリクエストします。

フィールド
sequence_id

string

必須。PhotoSequence の ID。

GetPhotoRequest

Photo の取得をリクエストします。

デフォルト

  • は写真バイトのダウンロード URL を返しません。

パラメータ:

  • view は、写真バイトのダウンロード URL を返すかどうかを制御します。
フィールド
photo_id

string

必須。Photo の ID。

view

PhotoView

必須。Photo レスポンスで写真バイトのダウンロード URL を返すかどうかを指定します。

language_code

string

「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。language_code を指定しない場合、Google サービスのユーザーの言語設定が使用されます。

GetPhotoSequenceRequest

PhotoSequence の取得をリクエストします。

デフォルト

  • PhotoSequence のダウンロード URL は返されません。

パラメータ:

  • view は、PhotoSequence のダウンロード URL が返されるかどうかを制御します。
フィールド
sequence_id

string

必須。フォト シーケンスの ID。

view
(deprecated)

PhotoView

PhotoSequence レスポンスの個々の写真の download_url で写真シーケンスのダウンロード URL を返すかどうかを指定します。

注: 現時点では実装されていません。

filter

string

省略可。フィルタ式。例: published_status=PUBLISHED

サポートされているフィルタは published_status です。詳しくは、https://google.aip.dev/160 をご覧ください。

GpsDataGapFailureDetails

ProcessingFailureReason#GPS_DATA_GAP に関する詳細。GPS データの欠落が複数ある場合は、時間が最も長いもののみがここにレポートされます。

フィールド
gap_duration

Duration

検出された GPS データの時間間隔。

gap_start_time

Duration

ギャップが始まった時点(動画ストリームの先頭からの相対時間)です。

Imu

デバイス センサーからの IMU データ。

フィールド
accel_mpsps[]

Measurement3d

加速度計の測定値はメートル/秒^2 で、デバイスからのタイムスタンプが増加しています。

gyro_rps[]

Measurement3d

ジャイロスコープの測定値(ラジアン/秒)。デバイスからのタイムスタンプが増加しています。

mag_ut[]

Measurement3d

デバイスからのタイムスタンプが増加しているマイクロテスラ(uT)単位の磁場の磁力計測定値。

3D 測定

一般的な 3D 測定サンプル。

フィールド
capture_time

Timestamp

IMU 測定のタイムスタンプ。

x

float

X 軸のセンサー測定値。

y

float

Y 軸のセンサー測定値。

z

float

Z 軸のセンサー測定値。

ImuDataGapFailureDetails

ProcessingFailureReason#IMU_DATA_GAP に関する詳細。IMU データの欠落が複数ある場合は、期間が最も長いもののみがここに表示されます。

フィールド
gap_duration

Duration

検出された IMU データの期間。

gap_start_time

Duration

ギャップが始まった時点(動画ストリームの先頭からの相対時間)です。

InsufficientGpsFailureDetails

ProcessingFailureReason#INSUFFICIENT_GPS に関する詳細。

フィールド
gps_points_found

int32

動画内で検出された GPS ポイントの数。

LatLngBounds

地理的座標の長方形。

フィールド
southwest

LatLng

これらの境界の南西の角。

northeast

LatLng

これらの境界の北東の角。

レベル

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

フィールド
number

double

省略可。注文に使用する階数。0 は地上レベル、1 は地上より 1 番上のレベル、-1 は地上より 1 番目のレベルを示します。整数以外の値は使用できます。

name

string

必須。このレベルに割り当てられた名前で、3 文字までに制限されます。エレベーターがある場合、この階のエレベーター ボタンにどうラベルが付けられるかを考慮してください。

ListPhotoSequencesRequest

リクエストを送信したユーザーに属するすべての写真シーケンスを一覧表示するリクエスト。

パラメータ:

  • pageSize は、返される写真シーケンスの最大数を決定します。
  • pageToken は、前の ListPhotoSequences リクエストから返された次のページトークンの値(存在する場合)です。
フィールド
page_size

int32

省略可。返される写真シーケンスの最大数。pageSize には負の値は指定できません。pageSize がゼロまたは指定されていない場合は、デフォルトのページサイズ 100 が使用されます。一致の数が pageSize 未満の場合、レスポンスで返される写真シーケンスの数は pageSize より少なくなる可能性があります。これは現在、実装されていませんが、処理中です。

page_token

string

省略可。前の ListPhotoSequences リクエストから返された nextPageToken 値(存在する場合)。

filter

string

省略可。フィルタ式。例: imagery_type=SPHERICAL

サポートされているフィルタは、imagery_typeprocessing_statemin_latitudemax_latitudemin_longitudemax_longitudefilename_querymin_capture_time_seconds、max_capture_time_seconds です。詳しくは、https://google.aip.dev/160 をご覧ください。複数の単語や特殊文字に対応するには、エスケープされた引用符を追加してファイル名のクエリをフレーズとして送信する必要があります。例: filename_query="フレーズの例.mp4"

ListPhotoSequencesResponse

ユーザーに属するすべての写真シーケンスの一覧表示に対するレスポンス。

フィールド
photo_sequences[]

Operation

Operation インターフェースを介したフォト シーケンスのリスト。

返されるアイテムの最大数は、リクエストの pageSize フィールドに基づきます。

リスト内の各アイテムの状態には、

  • Operation.done = false(PhotoSequence の処理がまだ終了していない場合)。
  • Operation.done = true。処理中にエラーが発生した場合、Operation.error が入力されます。
  • Operation.done = true で、Operation.responsePhotoSequence メッセージが含まれ、各シーケンスで Id のみが入力されます。
next_page_token

string

結果の次のページを取得するためのトークン。リストにそれ以上の結果がない場合は空です。

ListPhotosRequest

リクエストを送信したユーザーに属するすべての写真を一覧表示するリクエスト。

デフォルト

  • は写真バイトのダウンロード URL を返しません。

パラメータ:

  • view は、写真バイトのダウンロード URL を返すかどうかを制御します。
  • pageSize は、返される写真の最大数を決定します。
  • pageToken は、前の ListPhotos リクエストから返された次のページトークンの値(存在する場合)です。
  • filter を使用すると、特定のパラメータでフィルタリングできます。「placeId」現時点でパラメータのみがサポートされています
フィールド
view

PhotoView

必須。フォトのレスポンスで写真バイトのダウンロード URL を返すかどうかを指定します。

page_size

int32

省略可。返される写真の最大数です。pageSize には負の値は指定できません。pageSize がゼロまたは指定されていない場合は、デフォルトのページサイズ 100 が使用されます。ユーザーに属する写真の数が pageSize 未満の場合、レスポンスで返される写真の数は pageSize より少なくなる可能性があります。

page_token

string

省略可。前の ListPhotos リクエストから返された nextPageToken 値(存在する場合)。

filter

string

省略可。フィルタ式。例: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

サポートされているフィルタは placeIdmin_latitudemax_latitudemin_longitudemax_longitude です。詳しくは、https://google.aip.dev/160 をご覧ください。

language_code

string

省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。language_code を指定しない場合、Google サービスのユーザーの言語設定が使用されます。

ListPhotosResponse

ユーザーに属するすべての写真を一覧表示することに対するレスポンス。

フィールド
photos[]

Photo

写真のリスト。リクエストの pageSize フィールドによって、返されるアイテムの数が決まります。

next_page_token

string

結果の次のページを取得するためのトークン。リストにそれ以上の結果がない場合は空です。

NoOverlapGpsFailureDetails

PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS に関する詳細。

フィールド
gps_start_time

Timestamp

GPS 地点が最初に記録された時刻です。

gps_end_time

Timestamp

最後に記録された GPS 地点の時刻です。

video_start_time

Timestamp

動画の開始時間。

video_end_time

Timestamp

動画の終了時間。

NotOutdoorsFailureDetails

ProcessingFailureReason#NOT_OUTDOORS に関する詳細です。室内フレームが複数ある場合は、最初のフレームがここに記録されます。

フィールド
start_time

Duration

屋内フレームが検出されたときの相対時間(動画ストリームの先頭からの経過時間)。

写真

[写真] は、360°写真を写真のメタデータとともに保存するために使用されます。

フィールド
photo_id

PhotoId

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

upload_reference

UploadRef

入力のみの写真の作成時に必要です。入力のみの写真のバイトのアップロード先となるリソース URL。

download_url

string

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

thumbnail_url

string

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

pose

Pose

省略可。写真のポーズ。

connections[]

Connection

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

capture_time

Timestamp

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

upload_time

Timestamp

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

places[]

Place

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

view_count

int64

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

transfer_status

TransferStatus

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

maps_publish_status

MapsPublishStatus

出力専用。Google マップのステータス(この写真が公開されたかどうか)。

MapsPublishStatus

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

列挙型
UNSPECIFIED_MAPS_PUBLISH_STATUS 写真のステータスが不明です。
PUBLISHED 写真は Google マップで一般公開されます。
REJECTED_UNKNOWN なんらかの理由で写真が拒否されました。

TransferStatus

権利の移行のステータス。

列挙型
TRANSFER_STATUS_UNKNOWN この転送のステータスは不明です。
NEVER_TRANSFERRED この写真は転送されたことがありません。
PENDING この写真の転送は開始されましたが、受信者はまだ応答していません。
COMPLETED 写真の転送が完了し、この写真を受信者に転送しました。
REJECTED 受取人がこの写真転送を拒否しました。
EXPIRED 受取人がなんらかの操作を行う前に、写真の転送が期限切れになりました。
CANCELLED 送信者がこの写真転送をキャンセルしました。
RECEIVED_VIA_TRANSFER 権利が譲渡されたため、この写真の所有者は受取人にあります。

PhotoId

Photo の識別子。

フィールド
id

string

写真の一意の識別子。

PhotoResponse

BatchGetPhotosBatchUpdatePhotos を含むバッチ オペレーションでの単一の Photo に対するレスポンス ペイロード。

フィールド
status

Status

バッチ リクエストで 1 枚の写真を取得または更新するオペレーションのステータス。

photo

Photo

Photo リソース(リクエストが成功した場合)。

PhotoSequence

一連の 360° 写真とメタデータ。

フィールド
id

string

出力専用。フォト シーケンスの一意の識別子。アップロードが非同期で行われる場合、これは長時間実行オペレーション ID としても機能します。

photos[]

Photo

出力専用。タイムスタンプが増加している写真。

upload_reference

UploadRef

入力のみのフォト シーケンスを作成する場合は必須です。フォト シーケンスのバイト(動画形式)がアップロードされるリソース名。

capture_time_override

Timestamp

省略可。フォト シーケンスのキャプチャを開始する絶対時間。写真シーケンスが動画の場合、これは動画の開始時間です。このフィールドが入力に入力されている場合、動画ファイルまたは XDM ファイルのキャプチャ時間がオーバーライドされます。

upload_time

Timestamp

出力専用。この写真シーケンスが uSV ストア サービスで作成された時刻。

raw_gps_timeline[]

Pose

入力のみの各写真と時刻が同期されていない、デバイスからのタイムスタンプが増加している未加工の GPS 測定値。これらの未加工の測定値を使用して、各フレームのポーズを推測します。InputType が VIDEO で、未加工の GPS 測定値がカメラ モーション メタデータ トラック(CAMM)にない場合、入力では必須です。raw_gps_timeline とカメラ モーション メタデータ トラック(CAMM)の両方で未加工の GPS 測定値が提供されている場合は、gps_source を使用してどちらを優先するかを指定できます。

gps_source

GpsSource

入力のみのraw_gps_timeline とカメラ モーション メタデータ トラック(CAMM)の両方に GPS 測定値が含まれている場合は、どちらが優先されるかを示します。

imu

Imu

入力のみのコレクションの 3 軸 IMU データ。このデータが大きすぎてリクエストに入力できない場合は、動画の CAMM トラックに配置する必要があります。このデータは、同等の CAMM データが存在する場合は、常にそれよりも優先されます。

processing_state

ProcessingState

出力専用。このシーケンスの処理状態。

failure_reason

ProcessingFailureReason

出力専用。このシーケンスの processing_state = FAILED の場合は、失敗した理由が含まれます。Processing_state が他の値の場合、このフィールドは設定されません。

failure_details

ProcessingFailureDetails

出力専用。このシーケンスに failure_reason が設定されている場合、失敗に関する追加の詳細が含まれることがあります。

distance_meters

double

出力専用。フォト シーケンスの計算済み距離(メートル単位)。

sequence_bounds

LatLngBounds

出力専用。このフォト シーケンスのすべての画像をカプセル化する長方形のボックス。

view_count

int64

出力専用。この PhotoSequence 内の公開されたすべての画像が獲得した視聴回数の合計。

filename

string

出力専用。アップロードのファイル名。ディレクトリ パスは含まれません。ファイル名を提供するプラットフォームでシーケンスがアップロードされた場合にのみ使用できます。

GpsSource

GPS 測定値の主たる情報源。

列挙型
PHOTO_SEQUENCE raw_gps_timeline の GPS が存在する場合は、その GPS が優先されます。
CAMERA_MOTION_METADATA_TRACK カメラのモーション メタデータ トラック(CAMM)に GPS が存在する場合は、その GPS が優先されます。

PhotoView

レスポンスに含める Photo のビューを指定します。

列挙型
BASIC サーバーの応答には、写真バイトのダウンロード URL は含まれません。デフォルト値。
INCLUDE_DOWNLOAD_URL サーバーの応答には、写真バイトのダウンロード URL が含まれます。

場所

エンティティ用のメタデータを配置します。

フィールド
place_id

string

場所の ID(https://developers.google.com/places/place-id を参照)。

name

string

出力専用。language_code にローカライズされた場所の名前。

language_code

string

出力専用。名前のローカライズに使用される language_code。これはリクエストで指定された language_code である必要がありますが、フォールバックである可能性もあります。

ポーズ

エンティティの未加工のポーズの測定値。

フィールド
lat_lng_pair

LatLng

ポーズの緯度と経度のペア。詳しくは、https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng をご覧ください。Photo の作成時に緯度と経度のペアが指定されていない場合、exif ヘッダーの位置情報が使用されます。写真または EXIF のヘッダーに緯度と経度のペアが指定されていない場合、写真の処理が失敗します。

altitude

double

WGS84 楕円体から上までのポーズの高度(メートル単位)。NaN は測定されない数量を示します。

heading

double

次のポーズ パラメータは、写真の中心に関連するものです。これらは https://developers.google.com/streetview/spherical-metadata と一致します。コンパスの向き。写真の中心が北からの時計回りの度数で測定されます。0 以上 360 以下の値を指定してください。NaN は測定されない数量を示します。

pitch

double

ピッチ(写真の中央からの角度で測定)。値は -90 以上 90 以下にする必要があります。値が -90 の場合は真下を、90 の場合は真上を向いています。NaN は測定されない数量を示します。

roll

double

ロール(度単位)。0 以上 360 以下の値を指定してください。0 は水平線と同じ高さであることを示します。NaN は測定されない数量を示します。

gps_record_timestamp_unix_epoch

Timestamp

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

level

Level

垂直ナビゲーションの設定に使用するレベル(建物の階)。

accuracy_meters

float

このポーズの推定水平精度(メートル単位)。信頼度 68%(1 標準偏差)。たとえば Android では、この値は https://developer.android.com/reference/android/location/Location#getAccuracy() のメソッドから取得できます。他のプラットフォームでも、同様の精度を推定する方法は異なります。

ProcessingFailureDetails

ProcessingFailureReason 列挙型に付随する追加の詳細です。このメッセージは常に ProcessingFailureReason と組み合わせて使用されることが想定されており、このメッセージに設定されている oneof は FailureReason と一致する必要があります。

フィールド
共用体フィールド details。詳細のセットは 1 つのみ設定され、ProcessFailureReason の対応する列挙型と一致する必要があります。details は次のいずれかになります。
insufficient_gps_details

InsufficientGpsFailureDetails

InsufficientGpsFailureDetails をご覧ください。

gps_data_gap_details

GpsDataGapFailureDetails

GpsDataGapFailureDetails をご覧ください。

imu_data_gap_details

ImuDataGapFailureDetails

ImuDataGapFailureDetails をご覧ください。

not_outdoors_details

NotOutdoorsFailureDetails

NotOutdoorsFailureDetails をご覧ください。

no_overlap_gps_details

NoOverlapGpsFailureDetails

NoOverlapGpsFailureDetails をご覧ください。

ProcessingFailureReason

この PhotoSequence の処理に失敗した理由として考えられること。

列挙型
PROCESSING_FAILURE_REASON_UNSPECIFIED 失敗の理由が指定されていません。これはデフォルト値です。
LOW_RESOLUTION 動画フレームの解像度が小さすぎます。
DUPLICATE この動画は以前にアップロードされました。
INSUFFICIENT_GPS GPS 地点が少なすぎます。
NO_OVERLAP_GPS GPS トラックの時間間隔と動画の時間間隔が重なっていません。
INVALID_GPS GPS が無効である(例: すべての GPS ポイントが (0,0) にある)
FAILED_TO_REFINE_POSITIONS 一連の写真の位置を正確に特定できませんでした。
TAKEDOWN このシーケンスはポリシー上の理由により削除されました。
CORRUPT_VIDEO 動画ファイルが破損しているか、デコードできませんでした。
INTERNAL 基盤となるシステムで永続的な障害が発生した。
INVALID_VIDEO_FORMAT 動画形式が無効であるかサポートされていません。
INVALID_VIDEO_DIMENSIONS 無効な画像のアスペクト比が見つかりました。
INVALID_CAPTURE_TIME キャプチャ時間が無効です。タイムスタンプが未来からのタイムスタンプでした。
GPS_DATA_GAP GPS データに 5 秒を超える間隔が含まれています。
JUMPY_GPS GPS データが不安定で処理できません。
INVALID_IMU IMU(加速度計、ジャイロスコープなど)データが無効です。必須フィールド(x、y、z、または時間)が不足しているか、形式が正しくないなど、Google のシステムがデータを解析できない原因となっている可能性があります。
INSUFFICIENT_IMU IMU ポイントが少なすぎます。
INSUFFICIENT_OVERLAP_TIME_SERIES GPS、IMU、その他の時系列データのタイムフレームの重複が不十分です。
IMU_DATA_GAP IMU(加速度計、ジャイロスコープなど)データには、0.1 秒を超えるギャップがあります。
UNSUPPORTED_CAMERA カメラはサポートされていません。
NOT_OUTDOORS 一部のフレームが屋内で撮影されたため、サポートされていません。
INSUFFICIENT_VIDEO_FRAMES 動画フレームが不足しています。
INSUFFICIENT_MOVEMENT 移動データが不足しています。

ProcessingState

シーケンスの処理状態。状態は次のように変化します。

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

このシーケンスは、どの状態からでも FAILED に移行する可能性があります。また、処理されたシーケンスはいつでも再処理できます。

列挙型
PROCESSING_STATE_UNSPECIFIED 状態は指定されていません。これがデフォルト値です。
PENDING シーケンスの処理はまだ開始されていません。
PROCESSING シーケンスは現在処理中です。
PROCESSED シーケンスの位置の絞り込みを含む処理が終了しました。
FAILED シーケンスの処理に失敗しました。詳しくは、FailureReason をご覧ください。

UpdatePhotoRequest

Photo のメタデータを更新するためのリクエスト。写真のピクセルの更新はサポートされていません。

フィールド
photo

Photo

必須。新しいメタデータを含む Photo オブジェクト。

update_mask

FieldMask

必須。更新する写真メタデータのフィールドを識別するマスク。存在しない場合、このリクエストでは古い Photo メタデータが新しい Photo メタデータに完全に置き換えられます。無効なフィールドを指定すると、更新は失敗します。複数のフィールドをカンマ区切りリストで指定できます。

有効なフィールドは次のとおりです。

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

注: updateMask に繰り返しフィールドが含まれている場合、繰り返し値のセット全体が新しい内容で置き換えられます。たとえば、updateMaskconnections が含まれ、UpdatePhotoRequest.photo.connections が空の場合、すべての接続が削除されます。

UploadRef

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

フィールド
共用体フィールド file_source。必須。file_source は次のいずれかになります。
upload_url

string

アップロードの参照はユーザーごとに一意である必要があります。形式は「https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}」です。