เมื่อมีที่อยู่หรือรหัสวิดีโอที่ถูกต้อง เมธอด 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 จะแสดงคำตอบ 1 ใน 3 ข้อต่อไปนี้
หากมีวิดีโอ
lookupVideoจะแสดงผลสถานะการประมวลผลเป็นACTIVEรวมทั้ง URI แนวนอนและแนวตั้งสำหรับสื่อทุกประเภทที่รองรับ รวมถึงข้อมูลเมตาหากวิดีโออยู่ในระบบของเรา แต่ยังไม่แสดงผลอย่างสมบูรณ์
lookupVideoจะส่งคืนสถานะการประมวลผลเป็นPROCESSINGและvideoIdซึ่งคุณจะใช้เพื่อแสดงวิดีโอหลังจากแสดงผลเสร็จแล้วได้หากไม่มีวิดีโออยู่ API จะแสดงรหัสสถานะ 404 ในกรณีนี้ คุณสร้างวิดีโอใหม่ได้โดยเรียกใช้
renderVideo
วิธีใช้ URI ของวิดีโอที่แสดงผล
เรียกใช้เมธอด lookupVideo 1 ครั้งต่อที่อยู่ หรือ videoID ต่อข้อมูลพร็อพเพอร์ตี้ โดย URI ของวิดีโอในการตอบกลับนี้จะเรียกว่า URL ที่มีอายุสั้น ซึ่งจะหมดอายุหลังจากผ่านไประยะหนึ่ง
Google อัปเดตวิดีโอเป็นประจำ ดังนั้น เพื่อให้แน่ใจว่าคุณกำลังแสดงเนื้อหาล่าสุดแก่ลูกค้า ให้เรียกใช้เมธอด lookupVideo ทุกครั้งที่คุณแสดงวิดีโอ
การสนับสนุนวิดีโอที่เข้าถึงได้
Google แนะนำให้คุณเพิ่มข้อความถอดเสียงหรือคำอธิบายวิดีโอเมื่อแสดงวิดีโอมุมมองทางอากาศแก่ลูกค้า เพื่อรองรับการช่วยเหลือพิเศษ วิธีนี้ช่วยให้โปรแกรมอ่านหน้าจออ่านข้อความถอดเสียงหรือคำอธิบายให้ผู้ใช้ทราบได้ด้วย
ตัวอย่างเช่น เพิ่มคำอธิบายในแบบฟอร์มดังนี้
"นี่คือมุมมองทางอากาศแบบสมจริงของ ADDRESS ซึ่งได้รับจาก Google Maps"
คุณสามารถเพิ่มคำอธิบายวิดีโอแทนที่อยู่ในรูปแบบต่อไปนี้
"นี่คือมุมมองทางอากาศแบบสมจริงของตึกเอ็มไพร์สเตทในนิวยอร์กซึ่งจัดเตรียมโดย Google Maps"
บันทึกรหัสวิดีโอไว้ใช้ในภายหลัง
ตามข้อกำหนดเฉพาะบริการของ Aerial View API รหัสวิดีโอ Aerial View API จะได้รับการยกเว้นจากข้อจำกัดการแคชที่ระบุไว้ใน ส่วนที่ 3.2.3(b)(ไม่มีการแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform คุณจึงจัดเก็บค่ารหัสวิดีโอไว้ใช้ในภายหลังได้
ตัวอย่างคำขอที่ส่งที่อยู่
ตัวอย่างโค้ดต่อไปนี้ร้องขอวิดีโอมุมมองทางอากาศของพีระมิดทรานอเมริกา ซึ่งตั้งอยู่ที่ 600 มอนต์โกเมอรีสตรีต ซานฟรานซิสโก แคลิฟอร์เนีย 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 ซึ่งแต่ละรายการจะลิงก์ไปยังรูปแบบหรือเวอร์ชันที่แตกต่างกันของวิดีโอที่ขอ หากต้องการเรียนรู้เกี่ยวกับรูปแบบต่างๆ โปรดดู 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 "