เมธอด renderVideo
จะส่งคำขอสร้างวิดีโอมุมมองทางอากาศสำหรับที่อยู่ไปรษณีย์ของสหรัฐอเมริกาที่ระบุ หากมีวิดีโอสำหรับที่อยู่ที่ระบุอยู่แล้ว วิธีนี้จะแสดงข้อมูลเมตาเกี่ยวกับวิดีโอ
วิธีใช้ API
สร้างวิดีโอทางอากาศใหม่ด้วยการส่งคำขอ HTTPS POST ไปยังปลายทาง renderVideo
แล้วส่งคีย์ API และที่อยู่ไปรษณีย์ในสหรัฐอเมริกาดังที่แสดงในตัวอย่างต่อไปนี้ กระบวนการแสดงผลอาจใช้เวลา
ตั้งแต่ 1 ชั่วโมงไปจนถึง 2-3 ชั่วโมง
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
ตัวอย่างคำขอ
ตัวอย่างโค้ดต่อไปนี้ขอให้มีการสร้างวิดีโอมุมมองทางอากาศสำหรับ 500 W 2nd St, Austin, TX, 78701
curl -X POST -d '{ "address": "500 W 2nd St, Austin, TX 78701" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
ตัวอย่างการตอบกลับ
ตัวอย่างโค้ด JSON ต่อไปนี้แสดงการตอบสนองที่เป็นไปได้สำหรับคำขอวิดีโอตัวอย่าง
การตอบกลับที่อยู่ไม่ถูกต้อง
ที่อยู่ไม่ถูกต้องหรือไม่ได้อยู่ในสหรัฐอเมริกา
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
กำลังประมวลผลคำตอบ
ขณะนี้ Aerial View API กำลังแสดงวิดีโอของคุณ การตอบกลับจะมี videoId
ซึ่งคุณใช้เพื่อเรียกข้อมูลวิดีโอได้
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
กระบวนการแสดงผลอาจใช้เวลาตั้งแต่ 1 ชั่วโมงไปจนถึง 2-3 ชั่วโมง หากวิดีโอยังอยู่ระหว่างการประมวลผล คุณจะใช้ lookupVideo
เพื่อตรวจสอบสถานะวิดีโอได้จนกว่าจะแสดงผลเป็น ACTIVE
หากต้องการทำแบบสำรวจ โปรดส่งคำขอไปยัง lookupVideo
ซึ่งส่งผ่าน videoId
การแสดงผลอาจใช้เวลาหลายชั่วโมง ดังนั้นให้ใช้ Exponential Backoff เพื่อเว้นระยะเวลาระหว่างการโทร
คำตอบที่ใช้งานอยู่
เมื่อ renderVideo
แสดงผลค่า state
เป็น ACTIVE
หมายความว่าวิดีโอแสดงผลเสร็จแล้ว และคุณสามารถดึงข้อมูลได้โดยเรียกใช้ lookupVideo
ด้วย videoId
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}