Aerial View API の使用方法

Aerial View API は、2 つの一般的なワークフローをサポートしています。どちらのアプローチを使用するかは、リクエストする動画が存在するかどうかによって異なります。動画が存在するかどうか不明な場合は、 を使用して動画の状態を判断する必要があります。lookupVideoMetadata

動画を生成または取得するワークフロー

鳥瞰図動画を生成または取得するには、次のワークフローを使用します。

1. Google がその場所の動画をすでに生成しているかどうかを lookupVideoMetadata使用して確認します。
2. 動画が存在しない場合（lookupVideoMetadata が 404 を返した場合）、 renderVideo を呼び出して 新しい動画を生成します。
   1. videoId またはアドレスを使用して lookupVideoMetadata を呼び出し、動画の状態が ACTIVE になるまでエンドポイントをポーリングします。レンダリングには数時間かかる場合があるため、指数バックオフを使用して呼び出しの間隔を空けてください。

3. 動画がアクティブな場合（lookupVideoMetadata が ACTIVE の状態を返した場合）、 lookupVideo を呼び出して 動画の URI を取得します。

   注: Google が特定の住所の動画を生成すると、その動画は 誰でも利用できるようになります。つまり、動画は特定のユーザーやアカウントに関連付けられません。

このワークフローを次の図に示します。

後で使用するために動画 ID を保存する

Aerial View API のサービス固有の規約に従い、Aerial View API の動画 ID は、Google Maps Platform 利用規約のセクション 3.2.3（b）（キャッシュしない）で定められているキャッシュ制限の対象外となります。後で使用するために動画 ID の値を保存できます。