新しい動画を作成

renderVideo メソッドは、指定された米国の鳥瞰図動画の生成をリクエストします。 住所。指定した住所に動画がすでに存在する場合は、 メソッドは動画に関するメタデータを返します。

API の使用にあたっての注意事項

新しい空撮映像を生成するには、HTTPS POST リクエストを renderVideo API キーと米国の住所を渡します。以下の画像をご覧ください。 使用します。レンダリング プロセスには 1 時間から 数時間かかることもあります。

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

リクエスト例

次のコード例は、 500 W 2nd St, Austin, TX, 78701

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

レスポンスの例

次の JSON コードサンプルは、サンプル動画に対するレスポンスを示しています。 リクエストできます。

住所が無効であるというレスポンス

住所が正しくないか、米国内ではありません。

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

レスポンスを処理しています

Aerial View API が動画をレンダリングしています。レスポンスには、 videoId: 動画の取得に使用できます。

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

レンダリング プロセスには 1 時間から数時間かかることがあります。もし 動画はまだ処理中です。lookupVideo を使用して動画のステータスをポーリングできます ACTIVE の状態が返されるまで待機します。

ポーリングするには、videoId を渡して lookupVideo にリクエストを送信します。レンダリングは かかるため、指数関数的 バックオフを使用して通話の間隔を空けます。

アクティブな回答

renderVideostate の値 ACTIVE を返した場合は、動画に レンダリングが終了しました。これを取得するには、次のように lookupVideo を呼び出します。 videoId

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}