หน้านี้ได้รับการแปลโดย Cloud Translation API

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

เมธอด 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"
  }
}