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 stai richiedendo. Se non hai la certezza che il video esista, devi utilizzare lookupVideoMetadata per determinare lo stato del video.

Flusso di lavoro per generare o recuperare video

Utilizza il seguente flusso di lavoro per generare o recuperare un video con visuale 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.

Questo flusso di lavoro è rappresentato nel diagramma seguente:

Grafico che mostra il flusso di lavoro descritto sopra

Salvare gli ID video per un utilizzo futuro

Ai sensi dei Termini specifici di servizio per l'API Aerial View, gli ID video dell'API Aerial View sono esenti dalle limitazioni della 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 dell'ID video per utilizzarli in un secondo momento.