새 동영상 생성

이 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 상태를 반환할 때까지 동영상 상태를 폴링할 수 있습니다.

폴링하려면 lookupVideo에 요청을 보내 videoId를 전달합니다. 렌더링 기능 몇 시간이 걸릴 수 있으므로 지수 백오프합니다.

활성 응답

renderVideo가 ACTIVE의 state 값을 반환하면 동영상에 다음과 같은 사항이 있다는 뜻입니다. 렌더링이 완료되고 다음과 함께 lookupVideo를 호출하여 가져올 수 있습니다. videoId입니다.

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