Aerial View API verwenden

Die Aerial View API unterstützt zwei allgemeine Workflows. Ihr Ansatz hängt davon ab, ob das angeforderte Video vorhanden ist oder nicht. Wenn Sie nicht sicher sind, ob das Video vorhanden ist, verwenden Sie lookupVideoMetadata, um den Status des Videos zu ermitteln.

Workflow zum Generieren oder Abrufen von Videos

Verwenden Sie den folgenden Workflow, um ein Video aus der Vogelperspektive zu generieren oder abzurufen:

1. Prüfen Sie mit lookupVideoMetadata, ob Google bereits ein Video für den Standort erstellt hat.
2. Wenn kein Video vorhanden ist (lookupVideoMetadata hat einen 404-Fehler zurückgegeben), rufen Sie renderVideo auf, um ein neues Video zu generieren.
   1. Rufen Sie lookupVideoMetadata mit dem videoId oder der Adresse auf, um den Endpunkt abzufragen, bis der Status des Videos ACTIVE ist. Das Rendering kann mehrere Stunden dauern. Verwenden Sie daher den exponentiellen Backoff, um die Aufrufe zu begrenzen.

3. Wenn das Video aktiv ist (lookupVideoMetadata hat den Status ACTIVE zurückgegeben), rufe lookupVideo auf, um die URIs des Videos abzurufen.

   Hinweis :Nachdem Google das Video für eine bestimmte Adresse erstellt hat, ist es für jeden verfügbar. Das heißt, ein Video ist nicht mit einem bestimmten Nutzer oder Konto verknüpft.

Dieser Workflow wird im folgenden Diagramm dargestellt:

Video-IDs zur späteren Verwendung speichern

Vorbehaltlich der dienstspezifischen Nutzungsbedingungen für die Aerial View API sind die Video-IDs der Aerial View API von den Caching-Einschränkungen in Paragraf 3.2.3(b)(Kein Caching) der Nutzungsbedingungen für die Google Maps Platform ausgenommen. Sie können Video-ID-Werte daher zur späteren Verwendung speichern.