วิธีใช้ Aerial View API

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

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

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

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

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

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

เวิร์กโฟลว์นี้แสดงอยู่ในแผนภาพด้านล่าง

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

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