เมื่อมีที่อยู่หรือรหัสวิดีโอที่ถูกต้อง
lookupVideoMetadata
จะแสดงข้อมูลเมตาที่เชื่อมโยงกับวิดีโอที่ระบุ ข้อมูลเมตาใน
เนื้อหาการตอบกลับทำให้คุณสามารถพิจารณาความใหม่ของภาพ ความยาวของ
วิดีโอ และยังให้เวิร์กโฟลว์ฟรีในการยืนยันการมีอยู่ของวิดีโอ
วิธีใช้ API
เรียกใช้ปลายทางนี้โดยการส่งรหัสไปรษณีย์ของสหรัฐอเมริกาที่เข้ารหัส URL
ที่อยู่หรือ
videoId
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
จากนั้น API จะแสดงการตอบกลับแบบใดแบบหนึ่งจาก 2 รายการต่อไปนี้
- หากมีวิดีโอ
lookupVideoMetadata
จะแสดงข้อมูลเมตาของวิดีโอ - หากไม่มีวิดีโอ API จะแสดงรหัสข้อผิดพลาด 404
ตัวอย่างคำขอ
ตัวอย่างโค้ดต่อไปนี้ขอวิดีโอมุมมองทางอากาศของ Transamerica พีระมิดตั้งอยู่ที่ 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"
}
}