Method: videos.lookupVideo

Fetches a video given its address or videoId. The response will either be a video with a set of playback URIs for ACTIVE videos, a PROCESSING state for pending videos, or a 404 error if the video does not exist. Receiving a video is a billable event, so callers of this method should be ready to use the returned URIs at the time of request.

HTTP request

GET https://aerialview.googleapis /v1/videos:lookupVideo

The URL usesgRPC Transcodingsyntax.

Query parameters

Parameters
Union parameterkey.Required. A key used to look-up a video.keycan be only one of the following:
videoId

string

An ID returned fromvideos.renderVideo.

address

string

A US postal address.

Request body

The request body must be empty.

Response body

An object that encapsulates all of the data about a video.

If successful, the response body contains data with the following structure:

JSON representation
{
"uris":{
string:{
object (Uris)
},
...
},
"state":enum (State),
"metadata":{
object (VideoMetadata)
}
}
Fields
uris

map (key: string, value: object (Uris))

A mapping of media types to their URIs. This field is only included forACTIVEvideos. The key is an enum value fromMediaFormat.

An object containing a list of"key": valuepairs. Example:{ "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Current state of the render request.

metadata

object (VideoMetadata)

Contains the video's metadata, only set if the state isACTIVE.

Uris

Contains all the uris for a given video format.

JSON representation
{
"landscapeUri":string,
"portraitUri":string
}
Fields
landscapeUri

string

A signed short-lived URI for the media in a landscape orientation.

portraitUri

string

A signed short-lived URI for the media in a portrait orientation.