ดึงวิดีโอ

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

  • หากมีวิดีโอ lookupVideo จะแสดงสถานะการประมวลผลเป็น ACTIVE รวมถึงแสดง URI แนวนอนและแนวตั้งสำหรับสื่อทุกประเภทที่รองรับ และข้อมูลเมตา

  • หากวิดีโออยู่ในระบบของเราแต่ยังไม่ได้ผ่านการแสดงผลอย่างสมบูรณ์ lookupVideo จะแสดงสถานะการประมวลผลเป็น PROCESSING และ videoId ซึ่งคุณใช้เพื่อรับวิดีโอหลังจากที่ระบบแสดงผลเสร็จแล้วได้

  • หากไม่มีวิดีโออยู่ API จะแสดงรหัสสถานะ 404 ในกรณีนี้ คุณสามารถสร้างวิดีโอใหม่ได้โดยโทรไปที่ renderVideo

วิธีใช้ URI ของวิดีโอที่แสดงผล

เรียกใช้เมธอด lookupVideo 1 ครั้งต่อที่อยู่ หรือ videoID ต่อข้อมูลพร็อพเพอร์ตี้ URI ของวิดีโอในการตอบกลับเรียกว่า URI ที่มีอายุสั้นและจะหมดอายุหลังจากผ่านไประยะหนึ่ง

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

การรองรับวิดีโอที่เข้าถึงได้

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

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

"นี่คือภาพมุมสูงที่เหมือนภาพถ่ายจริงของ ADDRESS ซึ่ง Google Maps เป็นผู้จัดหา"

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

"นี่คือภาพมุมมองทางอากาศที่เหมือนภาพถ่ายของอาคารเอ็มไพร์สเตตในนิวยอร์กจาก Google Maps"

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

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

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

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

หากต้องการสำรวจ ให้ส่งคําขอไปยัง lookupVideo โดยส่ง videoId การแสดงผลอาจใช้เวลาหลายชั่วโมง ดังนั้นให้ใช้การลดจำนวนการเรียกใช้แบบทวีคูณเพื่อเว้นระยะเวลาในการเรียกใช้

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

ถ้าคุณโทรหา lookupVideo แล้วพบว่าไม่มีวิดีโอมุมมองทางอากาศ สำหรับที่อยู่นั้น คุณสามารถโทรหา renderVideo ด้วยที่อยู่นั้นได้ renderVideo แสดงผลออบเจ็กต์ VideoMetadata ซึ่งมี videoId คุณจะสามารถใช้ videoId แทนที่อยู่เพื่อรับวิดีโอในภายหลังได้โดยส่ง videoId ไปยัง lookupVideo

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเรียก lookupVideo โดยส่ง videoId

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&videoId=VIDEO_ID"