เมื่อมีที่อยู่หรือรหัสวิดีโอที่ถูกต้อง เมธอด lookupVideo จะแสดงผล URI ที่ระบุชุดวิดีโอ Aerial View API เมธอด lookupVideo จะแสดงผล URI เมื่อ Google ได้สร้างวิดีโอสำหรับสถานที่นั้นแล้วเท่านั้น
หากต้องการตรวจสอบว่ามีวิดีโอหรือไม่ ให้ใช้เมธอด lookupVideoMetadata
วิธีใช้ API
เรียกใช้ปลายทางนี้โดยส่งผ่านที่อยู่ไปรษณีย์ของสหรัฐอเมริกาที่เข้ารหัส URL หรือ videoId
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
จากนั้น API จะแสดงผลการตอบกลับหนึ่งใน 3 รายการต่อไปนี้
หากมีวิดีโอ
lookupVideoจะแสดงผลสถานะการประมวลผลACTIVEรวมถึง URI แนวนอนและแนวตั้งสำหรับสื่อทุกประเภทที่รองรับ รวมถึงข้อมูลเมตาหากวิดีโออยู่ในระบบของเราแต่วิดีโอยังคงแสดงผลไม่เสร็จสมบูรณ์
lookupVideoจะแสดงผลสถานะการประมวลผลเป็นPROCESSINGและvideoIdซึ่งคุณจะใช้เพื่อรับวิดีโอหลังจากที่แสดงผลเสร็จแล้วได้หากยังไม่มีวิดีโอ API จะแสดงรหัสสถานะ 404 ในกรณีนี้ คุณจะสร้างวิดีโอใหม่ได้โดยโทรไปที่
renderVideo
วิธีใช้ URI ของวิดีโอที่แสดงผล
เรียกใช้เมธอด lookupVideo 1 ครั้งต่ออีเมล หรือ videoID ต่อข้อมูลพร็อพเพอร์ตี้ URI วิดีโอในการตอบกลับเรียกว่า URI ที่มีอายุสั้น และจะหมดอายุหลังจากผ่านไปไม่นาน
Google อัปเดตวิดีโอเป็นประจำ ดังนั้นเพื่อให้แน่ใจว่าคุณกำลังแสดงเนื้อหาล่าสุดแก่ลูกค้า ให้เรียกใช้เมธอด lookupVideo ทุกครั้งที่คุณแสดงวิดีโอ
การรองรับวิดีโอที่เข้าถึงได้
Google ขอแนะนำให้คุณเพิ่มข้อความถอดเสียงหรือคำอธิบายวิดีโอ เมื่อคุณแสดงวิดีโอมุมมองทางอากาศแก่ลูกค้า วิธีนี้ช่วยให้โปรแกรมอ่านหน้าจออ่านข้อความถอดเสียงหรือคำอธิบายให้แก่ผู้ใช้ได้
ตัวอย่างเช่น เพิ่มคำอธิบายในแบบฟอร์ม
"นี่คือมุมมองทางอากาศแบบสมจริงของ ADDRESS จาก Google Maps"
คุณสามารถเพิ่มคำอธิบายวิดีโอในรูปแบบต่อไปนี้แทนที่อยู่
"นี่คือมุมมองทางอากาศแบบสมจริงของตึกเอ็มไพร์สเตตในนิวยอร์กจาก Google Maps"
บันทึกรหัสวิดีโอเพื่อใช้ในภายหลัง
ภายใต้ข้อกำหนดเฉพาะบริการสำหรับ Aerial View API รหัสวิดีโอของ Aerial View API จะได้รับการยกเว้นจากข้อจำกัดการแคชที่ระบุไว้ในส่วนที่ 3.2.3(ข)(ไม่มีการแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform ดังนั้นคุณจึงเก็บค่ารหัสวิดีโอไว้ใช้ภายหลังได้
ตัวอย่างคำขอที่ส่งผ่านที่อยู่
ตัวอย่างโค้ดต่อไปนี้ขอวิดีโอมุมมองทางอากาศสำหรับ Transamerica Pyramid ซึ่งตั้งอยู่ที่ 600 Montgomery St, San Francisco, CA 94111
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"
ตัวอย่างการตอบกลับ
ตัวอย่าง JSON ต่อไปนี้แสดงการตอบกลับที่เป็นไปได้ทั้งหมดสำหรับคำขอ lookupVideo
พบวิดีโอ
หากมีวิดีโอที่คุณขออยู่ API จะแสดงรายการ URI ซึ่งแต่ละ URL จะลิงก์ไปยังรูปแบบหรือเวอร์ชันที่แตกต่างกันของวิดีโอที่ขอ ดูข้อมูลเกี่ยวกับรูปแบบต่างๆ ได้ที่ MPEG-DASH คืออะไร | HLS กับ DASH
{
"uris": {
"IMAGE": {
"landscapeUri": "https://www.gstatic.com/aerialview/thumbnail/-1202461100507922431.jpg?sqp=CKiU6qIGGPQD&rs=AHRQkOe1j6EA5Q3WzJgDluv8AXbNlZ8M-g",
"portraitUri": "https://www.gstatic.com/aerialview/thumbnail/2256303413312618497.jpg?sqp=CKiU6qIGGPQD&rs=AHRQkOelSBTTVgOmFrSZ71c1xjyuoSBAAA"
},
"MP4_HIGH": {
"landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=375&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=37357139&dur=40.016&lmt=1683384545351664&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRgIhAOhUzpUZGXThRz481S5YAVoy7d7V29-8GDRWLdDEtzagAiEA5laBMqKNnoPCeTHFVT56FYQ5MZp7pZTtDNp9tSJffyc=&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgVqK6hzOoDaTnWt4UmIQgXOyGCc5Pxf4tmp2t6YzwkrQCIQCCOsPpfT2g_BT32Ki_iMwwBb2IhoquVISoHbBMI5_dAw==",
"portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=375&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=11844099&dur=40.016&lmt=1683384626250758&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRgIhAPP030ASCfKrXHpu72d78SBN_3T-7jKQ5_OjAvVzvYLaAiEAhEDAo689v0DWSCkfxxD8oU2iJVifC25Q7gQplx5_25U=&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgREl7bSQ_z9Y86A_bRnX1RdQqoIbwgjV2rEkhLlNilBICIQC9amH8IwmRdbbcCUxnSttBjcy_4BwiBBbSd_PM1KgICw=="
},
"MP4_LOW": {
"landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=134&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=3152145&dur=39.999&lmt=1683384843730359&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRAIgVDf8P_aMLthAC6ASciANODNo7p7IqofngIgCUnfUofYCICV7JexvuPTnaqOfShKIL33uhtzIfnfOj2LgfpY0zKdx&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIhAM2jKSXegkPbIFD4L7H6FeBz5ytYtMkXNfowGlAB9aL2AiA3DQJIeoTfs3EOIPMfDBCGm7v_vWTruRBjXLN4lRIa-Q==",
"portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=134&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=1002125&dur=39.999&lmt=1683384248881200&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRAIgYRyzRjtsGYFcodlU4-SvJ9GRgx97MF1nFlhoY74YtN4CIF5GuHAEnKqPoZBt5qYO2jur46q1OMEjvjtYATwNHMtD&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRgIhAPoXkJ5-MQTNCy19W1zJu8Hi8eo-eYw-5kH-AbFpAsuTAiEAi2EmxfUwfYtPlTQe0jWFVxc7yKMMz0Bqidcf2ZRvYU4="
},
"MP4_MEDIUM": {
"landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=374&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=25879743&dur=40.016&lmt=1683384621721411&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRQIhANzPUc2SwvlDZ-nyhxNfY8CGVjyitnfpS7MvbXb_f5kSAiAVArz85QjBBAZw-8ugFPIggKCO54IhR6xDg4rfJIh1Tw==&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgJJyNxWDuqLZ89X5wThN1IsVJyvyZ7Qw1Z4jqhCyahjgCIQD9hOjN3hDvX3CN5LiNkoLm-GGAuriUtv0PhtREc7yTVQ==",
"portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=374&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=8228161&dur=40.016&lmt=1683384373331986&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRQIgKsfEQB3GbLqYP5tmHwmkMVqVlfcNl7SBiuBqRw748VsCIQDgkwyNF4jOuOjoX5Qw6TgbpdIPhqS-EvCZ2g2JWPYpbw==&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgHdDEnopIcI2jzLkRLOaKz8Cq1Pwm2yl3nJzaru1dBEsCIQCgor9bkMfAeULTq3EwjzCGjB_RvGBqhGfhJblbBloJpg=="
},
"HLS": {
"landscapeUri": "https://manifest.googlevideo.com/api/manifest/hls_variant/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/playlist_type/LIVE/sparams/expire,ei,ip,id,source,susc,vprv,itag,playlist_type/sig/AOq0QJ8wRgIhAKreaNNOkePt9uVonHcqKIXqUe0TQSA1fcI6BWJexJ2hAiEAv9cj6N9iXI0bH6Ke4fz4XWDtrxVCMgrkGijpsLMpvy8%3D/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRgIhAMbA_78Uc_HUS8LaVWnJB4Qg7ZKO5IZECuhldckmJ3hPAiEA-GR-0w1zuyFHpvaF1LZBuWgpUM55iosY0KF9MMsePDE%3D/file/index.m3u8",
"portraitUri": "https://manifest.googlevideo.com/api/manifest/hls_variant/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/playlist_type/LIVE/sparams/expire,ei,ip,id,source,susc,vprv,itag,playlist_type/sig/AOq0QJ8wRgIhAKreaNNOkePt9uVonHcqKIXqUe0TQSA1fcI6BWJexJ2hAiEAv9cj6N9iXI0bH6Ke4fz4XWDtrxVCMgrkGijpsLMpvy8%3D/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRgIhAMbA_78Uc_HUS8LaVWnJB4Qg7ZKO5IZECuhldckmJ3hPAiEA-GR-0w1zuyFHpvaF1LZBuWgpUM55iosY0KF9MMsePDE%3D/file/index.m3u8"
},
"DASH": {
"landscapeUri": "https://manifest.googlevideo.com/api/manifest/dash/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/sparams/expire,ei,ip,id,source,susc,vprv,itag/sig/AOq0QJ8wRAIgCClKKnnVXeNnUHirpyxkegs8XSw5bq5e2VHWu-2NGtkCIBvXoHxlfTVmIvB4F9mlxn9EnJxPrcPGo1yIrS-_zbBu/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRQIhAIU_a8wIuPfzMXy1selgJ1bRz1ffXm0YQeFshe0ijAzhAiAPzhkpOjm-IGubZ-Z7o3W_U7lAjR6OkEpWvNEFCRzUVg%3D%3D",
"portraitUri": "https://manifest.googlevideo.com/api/manifest/dash/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/sparams/expire,ei,ip,id,source,susc,vprv,itag/sig/AOq0QJ8wRAIgCClKKnnVXeNnUHirpyxkegs8XSw5bq5e2VHWu-2NGtkCIBvXoHxlfTVmIvB4F9mlxn9EnJxPrcPGo1yIrS-_zbBu/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRQIhAIU_a8wIuPfzMXy1selgJ1bRz1ffXm0YQeFshe0ijAzhAiAPzhkpOjm-IGubZ-Z7o3W_U7lAjR6OkEpWvNEFCRzUVg%3D%3D"
}
},
"state": "ACTIVE",
"metadata": {
"videoId": "-wVXGP6Hkogfqz6sZulUf3",
"captureDate": {
"year": 2022,
"month": 10,
"day": 24
},
"duration": "40s"
}
}
หากต้องการเข้าถึงวิดีโอ คุณต้องเพิ่มโดเมนต่อไปนี้ในรายการที่อนุญาต
*.gstatic.com*.googlevideo.com
ไม่พบวิดีโอ
คำตอบที่เป็นไปได้คือ "ไม่พบวิดีโอ" มีอยู่ 2 แบบด้วยกัน ขึ้นอยู่กับว่าสถานที่นั้นๆ มีภาพ 3 มิติหรือไม่
ไม่ได้แสดงผล
วิดีโอไม่เคยแสดงผลมาก่อน จึงยังไม่อยู่ในฐานข้อมูลของ Google
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}
ไม่มีภาพ 3 มิติ
Google พยายามแสดงผลวิดีโอแล้ว แต่ไม่สำเร็จเนื่องจากไม่มีภาพ 3 มิติสำหรับที่อยู่นั้น
{
"error": {
"code": 404,
"message": "Video not found: No 3d imagery.",
"status": "NOT_FOUND"
}
}
กำลังแสดงผล
ระบบยังคงประมวลผลคำขอการแสดงผลตามที่กำหนดโดย state ที่ตั้งค่าเป็น PROCESSING คุณจะได้รับ videoId ซึ่งสามารถใช้เพื่อรับวิดีโอ
โดยโทรไปที่ lookupVideo ได้
{
"state": "PROCESSING",
"metadata": {
"videoId": "u-zlVPiScvcD8BYmIVyxoF"
}
}
โดยกระบวนการแสดงผลอาจใช้เวลาตั้งแต่ 1 ชั่วโมงไปจนถึง 2-3 ชั่วโมง หากวิดีโอยังอยู่ระหว่างการประมวลผล คุณจะใช้ lookupVideo เพื่อตรวจสอบสถานะวิดีโอจนกว่าวิดีโอจะแสดงสถานะ ACTIVE ได้
หากต้องการทำแบบสำรวจ ให้ส่งคำขอไปยัง lookupVideo ผ่าน videoId การแสดงผลอาจใช้เวลาหลายชั่วโมง ดังนั้นโปรดใช้ Exponential Backoff เพื่อเว้นช่วงการโทร
ตัวอย่างคำขอที่ส่งผ่าน videoId
หากโทรหา lookupVideo และพบว่าไม่มีวิดีโอมุมมองทางอากาศสำหรับที่อยู่นี้ คุณสามารถโทรหา renderVideo ด้วยที่อยู่ดังกล่าวได้
renderVideo แสดงผลออบเจ็กต์ VideoMetadata ซึ่งมี videoId คุณใช้ videoId แทนที่อยู่เพื่อรับวิดีโอได้โดยส่งต่อไปยัง lookupVideo
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเรียกใช้ lookupVideo ซึ่งส่งผ่าน videoId
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&videoId=VIDEO_ID "