วิธีใช้ Aerial View API

Aerial View API รองรับเวิร์กโฟลว์ทั่วไป 2 แบบ วิธีการของคุณจะขึ้นอยู่กับว่าวิดีโอที่คุณขอมีจริงหรือไม่ หากไม่แน่ใจว่าวิดีโอมีอยู่หรือไม่ ให้ใช้ lookupVideoMetadata เพื่อระบุสถานะของวิดีโอ

เวิร์กโฟลว์การสร้างหรือเรียกข้อมูลวิดีโอ

ใช้เวิร์กโฟลว์ต่อไปนี้เพื่อสร้างหรือเรียกข้อมูลวิดีโอมุมมองทางอากาศ:

1. ตรวจสอบว่า Google ได้สร้างวิดีโอสำหรับสถานที่นั้นแล้วหรือยังโดยใช้ lookupVideoMetadata
2. หากไม่มีวิดีโอ (lookupVideoMetadata แสดงผล 404) ให้เรียกใช้ renderVideo เพื่อสร้างวิดีโอใหม่
   1. เรียกใช้ lookupVideoMetadata โดยใช้ videoId หรือที่อยู่เพื่อส่งแบบสำรวจไปยังปลายทางจนกว่าสถานะของวิดีโอจะเป็น ACTIVE การแสดงผลอาจใช้เวลาหลายชั่วโมง ให้ใช้ Exponential Backoff เพื่อเว้นระยะเวลาสำหรับการโทร

3. หากวิดีโอทำงานอยู่ (lookupVideoMetadata คืนค่าสถานะ ACTIVE) ให้เรียกใช้ lookupVideo เพื่อดึงข้อมูล URI ของวิดีโอ

   หมายเหตุ: หลังจากที่ Google สร้างวิดีโอสำหรับที่อยู่ที่เจาะจงแล้ว ทุกคนจะดูวิดีโอดังกล่าวได้ กล่าวคือ วิดีโอไม่ได้เชื่อมโยงกับผู้ใช้หรือบัญชีใด

ขั้นตอนการทำงานนี้จะแสดงในแผนภาพด้านล่าง

บันทึกรหัสวิดีโอเพื่อใช้ในภายหลัง

ภายใต้ข้อกำหนดเฉพาะบริการสำหรับ Aerial View API รหัสวิดีโอ Aerial View API จะได้รับการยกเว้นจากข้อจำกัดการแคชที่ระบุไว้ในส่วนที่ 3.2.3(ข)(ไม่มีการแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform คุณจึงสามารถจัดเก็บค่ารหัสวิดีโอ ไว้ใช้ในภายหลังได้