ดึงวิดีโอ

เมื่อมีที่อยู่หรือรหัสวิดีโอที่ถูกต้อง 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"