หน้านี้ได้รับการแปลโดย Cloud Translation API

ดึงวิดีโอ

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

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