Come utilizzare l'API Aerial View

L'API Aerial View supporta due flussi di lavoro generali. L'approccio dipende dal fatto che il video che stai richiedendo esista o meno. Se non sai con certezza se il video esiste, devi utilizzare lookupVideoMetadata per determinare il suo stato.

Flusso di lavoro per generare o recuperare video

Per generare o recuperare un video con vista aerea:

1. Controlla se Google ha già generato un video per la località utilizzando lookupVideoMetadata.
2. Se non esiste alcun video (lookupVideoMetadata ha restituito un errore 404), chiama renderVideo per generare un nuovo video.
   1. Chiama lookupVideoMetadata utilizzando videoId o l'indirizzo per eseguire il polling dell'endpoint finché lo stato del video non sarà ACTIVE. Il rendering può richiedere diverse ore, quindi utilizza il backoff exponenciale per distanziare le chiamate.

3. Se il video è attivo (lookupVideoMetadata ha restituito lo stato ACTIVE), chiama lookupVideo per recuperare gli URI del video.

   Nota: dopo che Google ha generato il video per un indirizzo specifico, questo è disponibile per chiunque. In altre parole, un video non è associato a un utente o un account specifico.

Questo flusso di lavoro è rappresentato nel diagramma seguente:

Salvare gli ID video per utilizzarli in un secondo momento

Fatte salve le limitazioni relative alla memorizzazione nella cache indicate nella sezione 3.2.3(b)(No caching) dei Termini di servizio di Google Maps Platform, gli ID video dell'API Panoramica aerea sono esenti da queste limitazioni. Di conseguenza, puoi memorizzare i valori degli ID video per utilizzarli in un secondo momento.