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, sollten Sie lookupVideoMetadata
verwenden, um den Status des Videos zu ermitteln.
Workflow zum Generieren oder Abrufen von Videos
Verwenden Sie den folgenden Workflow, um ein Luftbildvideo zu erstellen oder abzurufen:
- Prüfe mit
lookupVideoMetadata
, ob Google bereits ein Video für den Standort generiert hat. - Wenn kein Video vorhanden ist (
lookupVideoMetadata
hat einen 404-Fehler zurückgegeben), rufen SierenderVideo
auf, um ein neues Video zu generieren.- Rufen Sie
lookupVideoMetadata
mit demvideoId
oder der Adresse auf, um den Endpunkt abzufragen, bis der Status des VideosACTIVE
lautet. Das Rendern kann mehrere Stunden dauern. Verwenden Sie daher den exponentiellen Backoff, um die Aufrufe zu zeitlich aufzuteilen.
- Rufen Sie
Wenn das Video aktiv ist (
lookupVideoMetadata
hat den StatusACTIVE
zurückgegeben), rufen SielookupVideo
auf, um die URIs des Videos abzurufen.
Dieser Workflow wird im folgenden Diagramm dargestellt:
Video-IDs zur späteren Verwendung speichern
Gemäß den dienstspezifischen Nutzungsbedingungen für die Aerial View API sind Video-IDs der Aerial View API von den Caching-Einschränkungen in Abschnitt 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.