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 richiesto. Se non hai la certezza che il video esista, utilizza lookupVideoMetadata per determinarne lo stato.

Flusso di lavoro per generare o recuperare video

Utilizza il seguente flusso di lavoro per generare o recuperare un video della 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 usando videoId o indirizzo per eseguire il polling dell'endpoint fino a quando lo stato del video è ACTIVE. Il rendering può richiedere diverse ore, quindi utilizza il backoff esponenziale per distribuire 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 chiunque. Ciò significa che un video non è associato a un utente o a un account specifico.

Questo flusso di lavoro è rappresentato nel diagramma seguente:

Salvare gli ID video per utilizzarli in un secondo momento

In conformità ai Termini specifici del servizio per l'API Aerial View, gli ID video dell'API Aerial View sono esenti dalle limitazioni sulla memorizzazione nella cache stabilite nella Sezione 3.2.3(b)(Nessuna memorizzazione nella cache) dei Termini di servizio di Google Maps Platform. Puoi quindi archiviare i valori degli ID video per utilizzarli in un secondo momento.