ดึงข้อมูลเมตาของวิดีโอ

เมื่อพิจารณาจากที่อยู่หรือรหัสวิดีโอที่ถูกต้อง เมธอด lookupVideoMetadata จะแสดงข้อมูลเมตาที่เชื่อมโยงกับวิดีโอที่ระบุ ข้อมูลเมตาในเนื้อหาการตอบกลับช่วยให้คุณพิจารณาความใหม่ของภาพ ความยาวของวิดีโอ และยังให้เวิร์กโฟลว์ฟรีเพื่อยืนยันการมีอยู่ของวิดีโอ

วิธีใช้ API

เรียกใช้ปลายทางนี้โดยการส่งที่อยู่ไปรษณีย์ของสหรัฐอเมริกาที่เข้ารหัส URL หรือ videoId

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

จากนั้น API จะแสดงการตอบกลับอย่างใดอย่างหนึ่งต่อไปนี้

• หากมีวิดีโออยู่ lookupVideoMetadata จะแสดงผลข้อมูลเมตาของวิดีโอ
• หากไม่มีวิดีโอ API จะแสดงรหัสข้อผิดพลาด 404

ตัวอย่างคำขอ

ตัวอย่างโค้ดต่อไปนี้ขอวิดีโอมุมมองทางอากาศสำหรับ Transamerica Pyramid ซึ่งตั้งอยู่ที่ 600 Montgomery St, San Francisco, CA 94111

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

ตัวอย่างการตอบกลับ

ตัวอย่าง JSON ต่อไปนี้แสดงการตอบสนองที่เป็นไปได้ทั้งหมดสำหรับคำขอ lookupVideoMetadata

พบวิดีโอ

วิดีโอแสดงผลแล้ว

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

วิดีโอกําลังแสดงผล

วิดีโอกําลังแสดงผล

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

ไม่พบวิดีโอ

วิดีโอไม่ได้อยู่ในฐานข้อมูลของ Google ซึ่งอาจเป็นเพราะสถานที่ตั้งนั้นยังไม่ได้แสดงผล หรือสถานที่ตั้งอยู่ในพื้นที่ที่ไม่รองรับ

หากตำแหน่งอยู่ในพื้นที่ที่รองรับ คุณจะใช้ renderVideo เพื่อเริ่มคำขอการแสดงผลได้

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}