Aerial View API は 2 つの一般的なワークフローをサポートしています。方法は、リクエストする動画が存在するかどうかによって異なります。動画が存在するかどうか不明な場合は、lookupVideoMetadata
を使用して動画の状態を判断する必要があります。
動画を生成または取得するためのワークフロー
鳥瞰図動画を生成または取得するには、次のワークフローを使用します。
lookupVideoMetadata
を使用して、ビジネスの動画が Google によってすでに生成されているかどうかを確認します。- 動画が存在しない場合(
lookupVideoMetadata
が 404 を返した場合)は、renderVideo
を呼び出して新しい動画を生成します。videoId
またはアドレスを使用してlookupVideoMetadata
を呼び出し、動画の状態がACTIVE
になるまでエンドポイントをポーリングします。レンダリングには数時間かかるため、指数バックオフを使用して呼び出し間隔を空けてください。
動画がアクティブな場合(
lookupVideoMetadata
がACTIVE
の状態を返した場合)、lookupVideo
を呼び出して動画の URI を取得します。
このワークフローを以下の図に示します。
動画 ID を後で使えるように保存する
Aerial View API 固有の利用規約に従い、Aerial View API 動画 ID は、Google Maps Platform 利用規約のセクション 3.2.3(b)(キャッシュの禁止)で定められているキャッシュ制限の対象外となります。そのため、後で使用するために動画 ID 値を保存できます。