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