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