동영상의 메타데이터를 가져옵니다.

유효한 주소 또는 동영상 ID가 주어지면 lookupVideoMetadata 드림 메서드는 지정된 동영상과 연결된 메타데이터를 반환합니다. 이미지의 신선도, 이미지의 길이 등을 동영상의 존재 여부를 확인할 수 있는 무료 워크플로도 제공합니다.

API 사용 방법

URL로 인코딩된 미국 우편번호를 전달하여 이 엔드포인트를 호출합니다. 주소 또는 videoId

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

그러면 API는 다음 두 응답 중 하나를 반환합니다.

• 동영상이 있으면 lookupVideoMetadata는 동영상의 메타데이터를 반환합니다.
• 동영상이 없으면 API는 404 오류 코드를 반환합니다.

요청 예시

다음 코드 샘플은 트랜스아메리카의 항공 뷰 동영상을 요청합니다. 피라미드, 600 Montgomery St, San Francisco, CA 94111

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

응답 예

다음 JSON 예는 lookupVideoMetadata 요청

동영상 찾음

동영상이 이미 렌더링되었습니다.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

동영상 렌더링 중

동영상을 렌더링하는 중입니다.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

동영상을 찾을 수 없습니다.

동영상이 Google의 데이터베이스에 없습니다. 아직 동영상이 업로드되지 않았거나 지원되지 않는 지역에 있는 경우

위치가 지원되는 국가 영역에 있는 경우 renderVideo 렌더링 요청을 시작할 수 있습니다.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}