ดึงวิดีโอ

เมื่อระบุที่อยู่หรือรหัสวิดีโอที่ถูกต้อง เมธอด 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 ของวิดีโอในการตอบกลับเรียกว่า URI ที่มีอายุสั้นและจะหมดอายุหลังจากผ่านไป ไม่นาน

Google จะอัปเดตวิดีโออยู่บ่อยครั้ง ดังนั้น เพื่อให้มั่นใจว่าคุณ แสดงเนื้อหาล่าสุดต่อลูกค้า ให้เรียกใช้เมธอด lookupVideo ทุกครั้งที่คุณแสดงวิดีโอ

การสนับสนุนวิดีโอที่เข้าถึงง่าย

Google ขอแนะนำให้คุณเพิ่มข้อความถอดเสียงหรือคำอธิบายวิดีโอเมื่อแสดงวิดีโอมุมสูงแก่ลูกค้าเพื่อรองรับการช่วยเหลือพิเศษ ด้วยวิธีนี้ โปรแกรมอ่านหน้าจอจะประกาศข้อความถอดเสียงหรือคำอธิบายให้ผู้ใช้ทราบได้

เช่น เพิ่มคำอธิบายในแบบฟอร์ม

"นี่คือภาพมุมสูงที่สมจริงของที่อยู่จาก Google Maps"

คุณอาจเพิ่มคำอธิบายวิดีโอในรูปแบบต่อไปนี้แทนที่อยู่

"นี่คือมุมมองทางอากาศที่สมจริงของตึกเอ็มไพร์สเตตในนิวยอร์ก ซึ่งให้บริการโดย Google Maps"

บันทึกรหัสวิดีโอไว้ใช้ในภายหลัง

ภายใต้ข้อกำหนดเฉพาะบริการสำหรับ Aerial View API รหัสวิดีโอของ Aerial View API จะได้รับการยกเว้นจากข้อจำกัดในการแคชที่ระบุไว้ในส่วน 3.2.3(b)(ห้ามแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform ดังนั้น คุณจึงจัดเก็บค่ารหัสวิดีโอเพื่อใช้ในภายหลังได้

ตัวอย่างคำขอที่ส่งผ่านที่อยู่

ตัวอย่างโค้ดต่อไปนี้จะขอวิดีโอมุมมองทางอากาศของอาคารทรานส์อเมริกา ไพรมิด ซึ่งตั้งอยู่ที่ 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 มิติของสถานที่นั้นพร้อมใช้งานหรือไม่

ไม่ได้เรนเดอร์

วิดีโอนี้ยังไม่ได้เรนเดอร์มาก่อน จึงยังไม่ได้อยู่ในฐานข้อมูลของ 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 การแสดงผลอาจใช้เวลาหลายชั่วโมง ดังนั้นให้ใช้ การถอยแบบทวีคูณ เพื่อเว้นระยะห่างการเรียก

ตัวอย่างคำขอที่ส่ง 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"