새 동영상 생성

renderVideo 메서드는 지정된 미국 우편 주소의 항공 뷰 동영상 생성을 요청합니다. 지정된 주소의 동영상이 이미 있는 경우 이 메서드는 동영상에 관한 메타데이터를 반환합니다.

API 사용 방법

다음 예와 같이 API 키와 미국 우편 주소를 전달하여 renderVideo 엔드포인트에 HTTPS POST 요청을 실행하여 새 항공 동영상을 생성합니다. 렌더링 프로세스는 1시간에서 몇 시간까지 걸릴 수 있습니다.

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

요청 예시

다음 코드 예는 텍사스주 오스틴 2번가 서쪽 500번지의 항공 뷰 동영상 생성을 요청합니다.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?X-Goog-Api-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에 요청합니다. 렌더링은 몇 시간 정도 걸릴 수 있으므로 지수 백오프를 사용하여 호출 간격을 늘립니다.

활성 응답

renderVideo가 ACTIVE의 state 값을 반환하면 동영상 렌더링이 완료되었으며 videoId로 lookupVideo를 호출하여 동영상을 검색할 수 있습니다.

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