วิธีใช้ 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 ดังนั้นคุณจึงจัดเก็บค่ารหัสวิดีโอ เพื่อใช้ในภายหลังได้