สร้างวิดีโอใหม่

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"
  }
}