數(shù)據(jù)可視化數(shù)據(jù)分析GIS【免費(fèi)下載鏈接】foliumPython Data. Leaflet.js Maps.項(xiàng)目地址https://gitcode.com/gh_mirrors/fo/folium點(diǎn)擊查看免費(fèi)下載Folium 的VideoOverlayfolium.raster_layers.VideoOverlay用于把一段視頻當(dāng)作一個(gè)圖層直接疊加到 Leaflet 交互地圖上是制作動(dòng)態(tài)可視化如氣象云圖動(dòng)畫、軌跡回放、實(shí)時(shí)監(jiān)控畫面的高效手段。本文將基于官方用戶指南文檔結(jié)合 folium/raster_layers.py 的類實(shí)現(xiàn)與相關(guān)工具函數(shù)系統(tǒng)講解VideoOverlay的用法、全部參數(shù)含義、底層渲染原理與實(shí)戰(zhàn)注意事項(xiàng)讀完即可在你的地圖項(xiàng)目中疊加視頻圖層。VideoOverlay 是什么VideoOverlay是 folium 柵格圖層raster layers家族的一員與TileLayer、ImageOverlay等同屬于folium.raster_layers模塊。它的作用是把指定 URL 的視頻文件以地理坐標(biāo)范圍bounds錨定到地圖上視頻畫面會(huì)隨地圖縮放、平移仿佛一塊動(dòng)態(tài)貼圖。典型應(yīng)用場(chǎng)景包括將衛(wèi)星云圖、雷達(dá)回波的視頻動(dòng)畫疊加到地圖區(qū)域上在地圖上回放移動(dòng)目標(biāo)如臺(tái)風(fēng)路徑、車輛軌跡的影像資料疊加實(shí)時(shí)視頻流或本地?cái)z像頭畫面與地理要素結(jié)合展示。從實(shí)現(xiàn)角度看VideoOverlay是對(duì) Leaflet 原生L.videoOverlay的 Python 封裝見(jiàn) folium/raster_layers.py 的類 docstringWraps leaflet TileLayer, WmsTileLayer (TileLayer.WMS), ImageOverlay, and VideoOverlay因此它繼承了 folium 圖層對(duì)象統(tǒng)一的渲染、疊加與圖層控制機(jī)制?？焖偕鲜忠欢瓮暾纠俜接脩糁改?video_overlay.md 給出了一個(gè)完整的可運(yùn)行示例將一段來(lái)自 NASA 的颶風(fēng)影像patricia_nasa.webm疊加到墨西哥以西的太平洋區(qū)域import folium m folium.Map(location[22.5, -115], zoom_start4) video folium.raster_layers.VideoOverlay( video_urlhttps://www.mapbox.com/bites/00188/patricia_nasa.webm, bounds[[32, -130], [13, -100]], opacity0.65, attrVideo from patricia_nasa, autoplayTrue, loopFalse, ) video.add_to(m) m這段代碼的關(guān)鍵點(diǎn)folium.Map(location[22.5, -115], zoom_start4)創(chuàng)建以颶風(fēng)區(qū)域?yàn)橹行牡牡貓D初始縮放級(jí)別 4保證視頻覆蓋范圍緯度 13°N~32°N、經(jīng)度 100°W~130°W基本落在視野內(nèi)VideoOverlay(...)構(gòu)造視頻圖層對(duì)象video_url指定視頻地址bounds指定視頻在地圖上的地理覆蓋范圍video.add_to(m)將圖層掛載到地圖對(duì)象m上這是 folium 圖層對(duì)象的標(biāo)準(zhǔn)掛載方式在 Notebook 環(huán)境中直接輸出m即可渲染地圖視頻圖層會(huì)自動(dòng)播放autoplayTrue。在 Jupyter Notebook 中執(zhí)行后你將看到地圖上出現(xiàn)一個(gè)半透明opacity0.65的、不循環(huán)播放的颶風(fēng)動(dòng)畫圖層。核心參數(shù)詳解基于源碼簽名VideoOverlay.__init__的完整簽名folium/raster_layers.py如下def __init__( self, video_url: str, bounds: TypeBounds, autoplay: bool True, loop: bool True, name: Optional[str] None, overlay: bool True, control: bool True, show: bool True, **kwargs: TypeJsonValue, ):各參數(shù)含義與默認(rèn)值如下表參數(shù)類型默認(rèn)值說(shuō)明video_urlstr必填視頻文件的 URL可以是 https 地址或相對(duì)/本地可訪問(wèn)的路徑最終會(huì)以 JSON 字符串形式寫入 Leaflet 調(diào)用boundslist/tuple必填視頻在地圖上的覆蓋范圍格式為[[lat_min, lon_min], [lat_max, lon_max]]形式的兩組經(jīng)緯度autoplayboolTrue地圖加載后視頻是否自動(dòng)播放loopboolTrue視頻是否循環(huán)播放namestrNone圖層在LayerControl中顯示的名稱為None時(shí)使用自動(dòng)生成的內(nèi)部名稱overlayboolTrue作為覆蓋圖層True在圖層控制中用復(fù)選框勾選還是底圖False用單選按鈕切換controlboolTrue是否將該圖層納入LayerControl圖層面板showboolTrue地圖打開時(shí)該圖層是否默認(rèn)顯示**kwargs——其他合法的 LeafletVideoOverlay選項(xiàng)會(huì)原樣傳入L.videoOverlay的 options 對(duì)象關(guān)于boundsbounds是視頻定位的核心。它由兩組經(jīng)緯度定義視頻在地圖上的矩形覆蓋區(qū)域。在示例中bounds[[32, -130], [13, -100]]即覆蓋緯度 13°N~32°N、經(jīng)度 100°W~130°W 的海域。在源碼內(nèi)部bounds會(huì)交給 normalize_bounds_type 做歸一化處理def normalize_bounds_type(bounds: TypeBounds) - TypeBoundsReturn: return [[float(x) if x is not None else None for x in y] for y in bounds]即把每個(gè)坐標(biāo)值轉(zhuǎn)換為float保證后續(xù)寫入 JavaScript 時(shí)格式合法。同時(shí)VideoOverlay還實(shí)現(xiàn)了_get_self_bounds()方法folium/raster_layers.py返回[[lat_min, lon_min], [lat_max, lon_max]]形式這意味著地圖的fit_bounds()、get_bounds()等自動(dòng)取景功能可以正確感知該圖層的覆蓋范圍。關(guān)于autoplay與loopautoplay與loop是視頻播放行為的關(guān)鍵開關(guān)autoplayTrue地圖渲染后視頻立即開始播放無(wú)需用戶點(diǎn)擊loopTrue視頻播放完畢后從頭重新播放適合循環(huán)動(dòng)畫如氣象云圖loopFalse只播放一遍。源碼中這兩個(gè)參數(shù)會(huì)被收集進(jìn) options 字典folium/raster_layers.pyself.options remove_empty(autoplayautoplay, looploop, **kwargs)remove_emptyfolium/utilities.py會(huì)剔除值為None的鍵保證最終生成的 options 對(duì)象干凈緊湊def remove_empty(**kwargs: TypeJsonValue) - dict[str, TypeJsonValueNoNone]: Return a dict without None values. return {key: value for key, value in kwargs.items() if value is not None}關(guān)于name、overlay、control、show這 4 個(gè)參數(shù)繼承自 folium 的Layer基類folium/map.py是所有圖層對(duì)象的通用行為約定name控制圖層面板中顯示的名字適合給視頻圖層起一個(gè)可讀的名字如颶風(fēng)動(dòng)畫overlayTrue視頻默認(rèn)作為覆蓋圖層overlay在地圖右下角圖層面板中以復(fù)選框形式出現(xiàn)若設(shè)為False則變成底圖以單選按鈕切換controlTrue加入LayerControl用戶可交互開關(guān)該圖層設(shè)False則圖層不可切換始終存在showTrue初始可見(jiàn)設(shè)False則地圖打開時(shí)視頻隱藏可配合controlTrue由用戶手動(dòng)打開。注意Layer.render()的實(shí)現(xiàn)folium/map.py表明只有showTrue時(shí)才會(huì)生成將圖層加入地圖的 JavaScript 指令addTo這是初始顯示在渲染層面的落地邏輯。關(guān)于**kwargs更多 Leaflet 原生選項(xiàng)官方示例中的opacity0.65和attrVideo from patricia_nasa正是通過(guò)**kwargs傳入的——它們不在VideoOverlay.__init__的顯式參數(shù)中而是被收集進(jìn)self.options后透?jìng)鹘o Leaflet 的L.videoOverlay。常見(jiàn)可用選項(xiàng)包括opacity圖層不透明度取值 0~1示例中0.65表示視頻半透明疊加可透出底圖attrattribution版權(quán)歸屬文字地圖上會(huì)顯示該標(biāo)注interactive視頻圖層是否響應(yīng)鼠標(biāo)事件如 tooltip 觸發(fā)crossOrigin是否以跨域方式加載視頻資源pane指定渲染層級(jí)面板如overlayPane。這些選項(xiàng)的最終效果以 LeafletVideoOverlay的官方參考為準(zhǔn)源碼 docstring 中亦注明Other valid (possibly inherited) options. See: leafletjs.com/reference.html#videooverlay。底層渲染原理Python 對(duì)象如何變成 JavaScript 調(diào)用VideoOverlay的核心在于其 Jinja2 模板_templatefolium/raster_layers.py{% macro script(this, kwargs) %} var {{ this.get_name() }} L.videoOverlay( {{ this.video_url|tojson }}, {{ this.bounds|tojson }}, {{ this.options|tojavascript }} ); {% endmacro %}渲染時(shí) folium 會(huì)依次填充三個(gè)部分{{ this.get_name() }}為這個(gè)圖層生成唯一的 JS 變量名如video_overlay_xxxx{{ this.video_url|tojson }}將視頻 URL 通過(guò)tojson序列化為合法的 JS 字符串字面量避免引號(hào)、反斜杠等特殊字符破壞腳本{{ this.bounds|tojson }}將歸一化后的 bounds 序列化為 JS 數(shù)組{{ this.options|tojavascript }}將remove_empty過(guò)濾后的 options 字典序列化為 JS 對(duì)象字面量作為L(zhǎng).videoOverlay的第三參數(shù)。最終生成的腳本大致形如var video_overlay_xxx L.videoOverlay( https://www.mapbox.com/bites/00188/patricia_nasa.webm, [[32, -130], [13, -100]], {opacity: 0.65, attribution: Video from patricia_nasa, autoplay: true, loop: false} );這就是 Python 端配置如何精準(zhǔn)傳遞到 Leaflet 的全過(guò)程。類似的渲染驗(yàn)證模式可以參考 tests/test_raster_layers.py 中test_image_overlay的寫法構(gòu)造對(duì)象 →add_to(m)→ 調(diào)用m._repr_html_()渲染 → 用Template渲染期望的腳本片段并與實(shí)際輸出比對(duì)。這為你在項(xiàng)目中驗(yàn)證VideoOverlay輸出提供了現(xiàn)成的測(cè)試思路當(dāng)前倉(cāng)庫(kù)測(cè)試集中以ImageOverlay的同類驗(yàn)證為主VideoOverlay的模板結(jié)構(gòu)與其高度一致可以推斷采用同樣的驗(yàn)證方式。實(shí)戰(zhàn)要點(diǎn)與注意事項(xiàng)1. 視頻 URL 的可訪問(wèn)性video_url需要是瀏覽器可以直接訪問(wèn)的地址。官方示例使用https://www.mapbox.com/bites/00188/patricia_nasa.webm這樣的公網(wǎng)視頻鏈接。若使用本地文件需要確保其能通過(guò) HTTP 服務(wù)被瀏覽器加載例如部署到 Web 服務(wù)器或使用 Notebook 內(nèi)嵌的靜態(tài)資源并注意瀏覽器對(duì)視頻格式如 WebM、MP4的原生支持情況。2. 與圖層控制LayerControl配合VideoOverlay默認(rèn)overlayTrue、controlTrue這意味著只要在地圖上添加folium.LayerControl()視頻圖層就會(huì)出現(xiàn)在圖層面板中用戶可以自由開關(guān)。這也是疊加層語(yǔ)義的完整體現(xiàn)。3. 自動(dòng)取景由于VideoOverlay實(shí)現(xiàn)了_get_self_bounds()當(dāng)視頻圖層掛載到地圖后可以通過(guò)地圖的取景方法如get_bounds()獲得包含視頻區(qū)域在內(nèi)的整體范圍方便自動(dòng)縮放定位到視頻覆蓋區(qū)域。4. 地圖渲染方式示例最后直接輸出m在 Jupyter Notebook / JupyterLab 中會(huì)調(diào)用_repr_html_()渲染完整地圖。在普通 Python 腳本中可以改用m.save(map.html)將地圖保存為獨(dú)立 HTML 文件再通過(guò)瀏覽器打開查看視頻疊加效果。小結(jié)folium.raster_layers.VideoOverlay用一段簡(jiǎn)潔的 Python 代碼就能把動(dòng)態(tài)視頻與地理坐標(biāo)系綁定是實(shí)現(xiàn)會(huì)動(dòng)的地圖圖層的利器。核心要點(diǎn)可以概括為必填參數(shù)只有兩個(gè)video_url視頻地址與bounds地理覆蓋范圍播放行為由autoplay/loop控制默認(rèn)自動(dòng)播放且循環(huán)視覺(jué)與交互細(xì)節(jié)通過(guò)**kwargs透?jìng)鹘o Leaflet如opacity、attr顯式參數(shù)之外的合法 Leaflet 選項(xiàng)均可使用圖層管理行為name、overlay、control、show與 folium 所有Layer子類統(tǒng)一可無(wú)縫融入LayerControl。想進(jìn)一步深挖可以閱讀 folium/raster_layers.py 的VideoOverlay類實(shí)現(xiàn)、folium/map.py 的Layer基類以及 folium/utilities.py 中的normalize_bounds_type與remove_empty工具函數(shù)倉(cāng)庫(kù)中的 ImageOverlay 測(cè)試 也可作為理解其渲染輸出格式的參考。贊分享數(shù)據(jù)可視化數(shù)據(jù)分析GIS【免費(fèi)下載鏈接】foliumPython Data. Leaflet.js Maps.項(xiàng)目地址https://gitcode.com/gh_mirrors/fo/folium點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Leaflet 視頻覆蓋層VideoOverlay實(shí)戰(zhàn)在地圖上疊加無(wú)控件視頻層Leaflet 視頻覆蓋層VideoOverlay實(shí)戰(zhàn)在地圖上疊加無(wú)控件視頻層 視頻覆蓋層 VideoOverlay 是 Leaflet 提供的三大覆前端數(shù)據(jù)可視化GISLeaflet VideoOverlay 視頻疊加層實(shí)戰(zhàn)指南從地圖內(nèi)嵌視頻到自定義播放控制Leaflet VideoOverlay 視頻疊加層實(shí)戰(zhàn)指南從地圖內(nèi)嵌視頻到自定義播放控制 在 Leaflet 中 VideoOverlay 用于在指定地理前端數(shù)據(jù)可視化GISFlet 地圖疊加圖片 OverlayImage 完全指南在 Python 中給地圖疊加任意圖片圖層Flet 地圖疊加圖片 OverlayImage 完全指南在 Python 中給地圖疊加任意圖片圖層 導(dǎo)讀 OverlayImage 是 flet_map 擴(kuò)前端跨平臺(tái)桌面應(yīng)用移動(dòng)開發(fā)上一篇國(guó)家中小學(xué)智慧教育平臺(tái)電子課本下載完整指南3分鐘輕松獲取離線教材下一篇微信聊天記錄永久保存WeChatMsg完全指南讓珍貴對(duì)話永不丟失創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考