Come utilizzare l'API Aerial View

L'API Aerial View supporta due flussi di lavoro generali. Il tuo approccio dipende dall'esistenza o meno del video che hai richiesto. Se non hai la certezza che il video esista, devi utilizzare lookupVideoMetadata per determinarne lo stato.

Flusso di lavoro per generare o recuperare video

Per generare o recuperare un video di visualizzazione aerea, utilizza il seguente flusso di lavoro:

1. Verifica se Google ha già generato un video per la località utilizzando lookupVideoMetadata.
2. Se non esiste nessun 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 diventa 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 ha generato il video per un indirizzo specifico, quel video è disponibile per tutti. Ciò significa che un video non è associato a un utente o account specifico.

Questo flusso di lavoro è rappresentato nel diagramma seguente:

Salva gli ID video per utilizzarli in un secondo momento

Soggetti ai Termini specifici del servizio per l'API Aerial View, gli ID video dell'API Aerial View sono esenti dalle restrizioni per la 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 ID video per utilizzarli in un secondo momento.