Aerial View API nasıl kullanılır?

Aerial View API, iki genel iş akışını destekler. Yaklaşımınız, talep ettiğiniz videonun mevcut olup olmadığına bağlıdır. Videonun mevcut olup olmadığından emin değilseniz videonun durumunu belirlemek için lookupVideoMetadata kullanmanız gerekir.

Video oluşturma veya alma iş akışı

Kuşbakışı görünüm videosu oluşturmak veya almak için aşağıdaki iş akışını kullanın:

  1. Google'ın lookupVideoMetadata kullanarak konum için video oluşturup oluşturmadığını kontrol edin.
  2. Video yoksa (lookupVideoMetadata 404 döndürdü) yeni bir video oluşturmak için renderVideo işlevini çağırın.
    1. Videonun durumu ACTIVE olana kadar uç noktayı yoklamak için videoId veya adresi kullanarak lookupVideoMetadata işlevini çağırın. Oluşturma işlemi birkaç saat sürebilir. Bu nedenle, çağrılarınızın arasına zaman koymak için üstel geri çekilme kullanın.

  3. Video etkinse (lookupVideoMetadata, ACTIVE durumunu döndürdüyse) videonun URI'lerini getirmek için lookupVideo işlevini çağırın.

Bu iş akışı aşağıdaki şemada gösterilmektedir:

Yukarıda özetlenen iş akışını gösteren grafik

Video kimliklerini daha sonra kullanmak üzere kaydetme

Aerial View API'nin Hizmete Özgü Şartları'na tabi olarak Aerial View API video kimlikleri, Google Haritalar Platformu Hizmet Şartları'nın Bölüm 3.2.3(b)(Önbelleğe Alma Yok)'te belirtilen önbelleğe alma kısıtlamalarından muaftır. Bu nedenle, video kimliği değerlerini daha sonra kullanmak üzere saklayabilirsiniz.