เมื่อมีที่อยู่หรือรหัสวิดีโอที่ถูกต้อง
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(ข)(ไม่มีการแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform คุณจึงสามารถจัดเก็บ ค่ารหัสวิดีโอเพื่อใช้ในภายหลัง
ตัวอย่างคำขอที่ส่งที่อยู่
ตัวอย่างโค้ดต่อไปนี้ขอวิดีโอมุมมองทางอากาศของ Transamerica พีระมิดตั้งอยู่ที่ 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 โดยแต่ละรายการ ที่ลิงก์กับรูปแบบหรือเวอร์ชันอื่นของวิดีโอที่ขอ เพื่อเรียนรู้ เกี่ยวกับรูปแบบต่างๆ โปรดดู 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 มิติมีให้บริการสำหรับสถานที่นั้น
ไม่ได้แสดงผล
วิดีโอยังไม่มีการแสดงผลก่อนหน้านี้ จึงยังไม่อยู่ใน ฐานข้อมูล
{
"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 "