Come utilizzare l'API Aerial View

L'API Aerial View supporta due flussi di lavoro generali. Il tuo approccio dipende dal fatto che il video che stai richiedendo esista o meno. Se non sei sicuro che il video esista, devi utilizzare lookupVideoMetadata per determinarne lo stato.

Flusso di lavoro per generare o recuperare video

Utilizza il seguente workflow per generare o recuperare un video di 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 è ACTIVE. Il rendering può richiedere diverse ore, quindi utilizza il backoff esponenziale 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 genera il video per un indirizzo specifico, il video è disponibile per chiunque. Ovvero, un video non è associato a un utente o un account specifico.

Questo flusso di lavoro è rappresentato nel seguente diagramma:

Salvare gli ID video per un utilizzo successivo

Ai sensi dei Termini specifici di servizio per l'API Aerial View, gli ID video dell'API Aerial View sono esenti dalle limitazioni di memorizzazione nella cache indicate nella Sezione 3.2.3(b)(Nessuna memorizzazione nella cache) dei Termini di servizio di Google Maps Platform. Puoi quindi memorizzare i valori degli ID video per un utilizzo successivo.