วิธีใช้ Aerial View API

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

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

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

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

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

แผนภูมิแสดงเวิร์กโฟลว์ที่ระบุไว้ข้างต้น

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

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