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 の pose.heading、pose.pitch、pose.roll、pose.altitude、pose.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 種類のレスポンスを返します。

  • PhotoSequence の処理がまだ終了していない場合、Operation.done = false。
  • 処理中にエラーが発生した場合、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 のデータをアップロードします。

アップロードが完了したら、UploadRef を CreatePhotoSequence とともに使用して 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 に記載されている写真の要件に加えて、写真は次の要件を満たしている必要があります。

アップロードが完了したら、このメソッドは UploadRef と CreatePhoto を使用して 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

必須。Photo レスポンスで写真バイトのダウンロード 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 の結果のリスト（リクエストと同じ順序で）。

Connection（つながり）

結合とは、ソースの写真から宛先の写真へのリンクのことです。

フィールド
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 拡張可能なデバイス メタデータ（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 の取得をリクエストします。

デフォルト

パラメータ:

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

string

必須。フォトシーケンスの ID。
view
(deprecated)

PhotoView

PhotoSequence レスポンスで写真シーケンスのダウンロード URL を個々の写真の download_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 データ。

フィールド
accel_mpsps[]

Measurement3d

加速度計の測定値（メートル/秒^2 単位）。デバイスのタイムスタンプが増加しています。
gyro_rps[]

Measurement3d

デバイスからのタイムスタンプが増加しているジャイロスコープの測定値（ラジアン/秒）。
mag_ut[]

Measurement3d

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

Measurement3d

一般的な 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_type、processing_state、min_latitude、max_latitude、min_longitude、max_longitude、filename_query、min_capture_time_seconds、max_capture_time_seconds です。詳しくは、https://google.aip.dev/160 をご覧ください。ファイル名のクエリは、エスケープされた引用符を追加して複数の単語や特殊文字に対応するには、フレーズとして送信する必要があります。例: filename_query="example of aphrase.mp4"

ListPhotoSequencesResponse

ユーザーに属するすべてのフォト シーケンスを一覧表示するレスポンス。

フィールド
photo_sequences[]

Operation

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

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

リスト内の各アイテムには 3 つの状態があります。

  • PhotoSequence の処理がまだ終了していない場合、Operation.done = false。
  • 処理中にエラーが発生した場合、Operation.done = true になり、Operation.error が入力されます。
  • Operation.done = true で、Operation.response には PhotoSequence メッセージが含まれます。各シーケンスでは、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。

サポートされているフィルタは placeId、min_latitude、max_latitude、min_longitude、max_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.view が PhotoView.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

BatchGetPhotos や BatchUpdatePhotos などのバッチ オペレーションにおける、単一の 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 測定値が Camera Motion Metadata Track（CAMM）にない場合の入力に必須。raw_gps_timeline と Camera Motion Metadata Track（CAMM）の両方で未加工の GPS 測定値が提供された場合、ユーザーは gps_source を使用してどちらが優先されるかを示すことができます。
gps_source

GpsSource

入力のみ。raw_gps_timeline と Camera Motion Metadata Track（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 がある場合は、それが優先されます。
CAMERA_MOTION_METADATA_TRACK Camera Motion Metadata Track（CAMM）の 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、time）が不足している、形式が正しくないなど、システムで解析を妨げるその他の問題がある可能性があります。
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 に繰り返しフィールドが含まれている場合、繰り返し値のセット全体が新しい内容に置き換えられます。たとえば、updateMask に connections が含まれ、UpdatePhotoRequest.photo.connections が空の場合、すべての接続が削除されます。

UploadRef

メディア ファイルの参照をアップロードしてください。

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

string

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