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