簡(jiǎn)介這份資源面向需要在MATLAB環(huán)境中調(diào)用谷歌地圖的開(kāi)發(fā)者與地理數(shù)據(jù)分析學(xué)習(xí)者圍繞靜態(tài)地圖請(qǐng)求、圖片顯示與地理數(shù)據(jù)可視化等場(chǎng)景提供可運(yùn)行的示例工程。壓縮包共8個(gè)文件約15KB以m腳本、fig圖形界面文件與txt說(shuō)明文檔為主另含少量工程緩存文件便于直接打開(kāi)對(duì)照學(xué)習(xí)。已有500人學(xué)習(xí)下載適合作為入門(mén)參考。資源核心價(jià)值在于把MATLAB的Web服務(wù)函數(shù)與谷歌地圖API串聯(lián)起來(lái)通過(guò)webread請(qǐng)求指定經(jīng)緯度、縮放級(jí)別與地圖類(lèi)型的靜態(tài)地圖再用imshow展示同時(shí)演示geoplot、geobubble等函數(shù)將經(jīng)緯度數(shù)據(jù)點(diǎn)疊加到地圖上并涉及JavaScript交互式地圖的調(diào)用思路。配套說(shuō)明文檔與圖形界面文件可幫助讀者理解參數(shù)配置、API密鑰使用及免費(fèi)額度限制快速搭建自己的地理可視化小項(xiàng)目。1. 裝 MATLAB 谷歌地圖工具前先把版本和依賴(lài)對(duì)齊上周幫一個(gè)做遙感課題的 A 同學(xué)收拾環(huán)境他機(jī)器上 MATLAB R2023b 裝好了谷歌地圖工具箱也解壓了結(jié)果一跑示例就報(bào)Undefined function plot_google_map。翻來(lái)覆去折騰兩小時(shí)最后發(fā)現(xiàn)是工具箱目錄壓根沒(méi)進(jìn)搜索路徑而他把問(wèn)題歸咎于“版本不兼容”。這類(lèi)翻車(chē)在 MATLAB 谷歌地圖環(huán)境搭建里太常見(jiàn)了工具本身不復(fù)雜坑全在版本、路徑和網(wǎng)絡(luò)這三件事上。這篇筆記按我實(shí)際裝機(jī)的順序走一遍從版本選擇、依賴(lài)確認(rèn)、下載解壓、路徑配置到最后的出圖驗(yàn)證每一步都給命令和參數(shù)說(shuō)明新手能照著跑通熟手能對(duì)照看版本差異和參數(shù)取舍。適合做地理數(shù)據(jù)可視化、軌跡繪制、遙感底圖疊加的開(kāi)發(fā)者尤其是第一次在 MATLAB 里接谷歌地圖底圖的人。2. 環(huán)境準(zhǔn)備MATLAB 版本、工具箱依賴(lài)與目錄規(guī)劃2.1 MATLAB 版本怎么選R2018b 之后基本都能跑這套谷歌地圖工具的核心是一組.m文件靠 MATLAB 的webread、urlread、jsondecode這些內(nèi)置函數(shù)去請(qǐng)求地圖瓦片和地理編碼接口。所以版本下限取決于這些函數(shù)什么時(shí)候穩(wěn)定。我的經(jīng)驗(yàn)是 R2018b 及以上最省心因?yàn)閣ebread對(duì) HTTPS 和超時(shí)的處理在那之后比較穩(wěn)R2016b 到 R2018a 也能跑但遇到證書(shū)或重定向時(shí)容易卡住需要手動(dòng)改請(qǐng)求方式。R2014b 以前不建議碰jsondecode都沒(méi)有得換老版本解析邏輯。MATLAB 版本支持情況說(shuō)明R2020b 及以上推薦webread穩(wěn)定jsondecode完整示例可直接跑R2018b ~ R2020a可用個(gè)別接口需手動(dòng)設(shè)超時(shí)基本無(wú)礙R2016b ~ R2018a勉強(qiáng)可用HTTPS 請(qǐng)求偶發(fā)失敗需改weboptionsR2014b 以前不建議缺jsondecode需替換解析函數(shù)選版本時(shí)還要看你的操作系統(tǒng)。Windows 10/11 和 macOS 12 以上都沒(méi)問(wèn)題Linux 下要注意 MATLAB 自帶的 CA 證書(shū)路徑常見(jiàn)做法是設(shè)SSL_CERT_FILE環(huán)境變量指向系統(tǒng)證書(shū)否則請(qǐng)求地圖瓦片會(huì)報(bào)證書(shū)錯(cuò)誤。我一般會(huì)在裝之前先跑一句ver確認(rèn)版本再跑which webread確認(rèn)函數(shù)存在兩步就能排除大半版本問(wèn)題。2.2 依賴(lài)確認(rèn)三個(gè)內(nèi)置函數(shù)和一個(gè)網(wǎng)絡(luò)出口這套工具不依賴(lài)額外工具箱但依賴(lài) MATLAB 內(nèi)置的幾個(gè)網(wǎng)絡(luò)與解析函數(shù)。裝之前先在命令行逐條確認(rèn)% 確認(rèn)關(guān)鍵函數(shù)存在缺任何一個(gè)都說(shuō)明版本過(guò)低 assert(exist(webread,file) 2, 缺少 webread請(qǐng)升級(jí) MATLAB); assert(exist(jsondecode,file) 2, 缺少 jsondecode請(qǐng)升級(jí) MATLAB); assert(exist(weboptions,file) 2, 缺少 weboptions請(qǐng)升級(jí) MATLAB); disp(依賴(lài)檢查通過(guò));這三行assert的邏輯很直白exist(...,file)返回 2 表示找到對(duì)應(yīng)函數(shù)文件返回 0 就直接拋錯(cuò)并給出提示。webread負(fù)責(zé)發(fā) HTTP 請(qǐng)求拿瓦片和地理編碼結(jié)果jsondecode負(fù)責(zé)把返回的 JSON 轉(zhuǎn)成結(jié)構(gòu)體weboptions用來(lái)設(shè)超時(shí)、請(qǐng)求頭這些參數(shù)。少任何一個(gè)后面配置再對(duì)也跑不起來(lái)。網(wǎng)絡(luò)出口這塊要單獨(dú)說(shuō)一句。工具請(qǐng)求的是地圖瓦片和地理編碼服務(wù)需要機(jī)器能正常訪問(wèn)對(duì)應(yīng)服務(wù)地址。常見(jiàn)做法是先在瀏覽器里打開(kāi)一次地圖頁(yè)面確認(rèn)能出圖再回 MATLAB 里跑請(qǐng)求如果瀏覽器能開(kāi)而 MATLAB 報(bào)連接超時(shí)多半是 MATLAB 的代理設(shè)置沒(méi)跟上系統(tǒng)去主頁(yè) → 環(huán)境 → 并行 → 代理設(shè)置里對(duì)齊一下即可。這一步不涉及任何特殊配置就是普通的網(wǎng)絡(luò)連通性確認(rèn)。2.3 目錄規(guī)劃別把工具箱丟進(jìn) MATLAB 安裝目錄我見(jiàn)過(guò)最常見(jiàn)的壞習(xí)慣是把下載的.m文件直接復(fù)制進(jìn)matlabroot/toolbox下面。這樣做短期能跑升級(jí) MATLAB 時(shí)全丟而且多版本共存時(shí)互相覆蓋排查起來(lái)是黑匣子。正確做法是單獨(dú)建一個(gè)工作目錄比如D:\matlab_tools\google_mapWindows或~/matlab_tools/google_mapmacOS/Linux把工具文件放進(jìn)去再把這個(gè)目錄加進(jìn)搜索路徑。目錄里通常包含主函數(shù)文件、示例腳本和可能的輔助函數(shù)。解壓后先dir看一眼結(jié)構(gòu)確認(rèn)主函數(shù)在根層還是子目錄里。如果主函數(shù)在子目錄加路徑時(shí)要加到子目錄那一層或者用addpath(genpath(...))遞歸加。我一般傾向后者省得漏文件但要注意genpath會(huì)把.git、test這類(lèi)目錄也加進(jìn)來(lái)路徑多了啟動(dòng)變慢所以更穩(wěn)的做法是手動(dòng)指定到具體子目錄。3. 下載與安裝解壓、放路徑、寫(xiě)初始化腳本3.1 解壓與文件核對(duì)先確認(rèn)主函數(shù)在哪一層拿到壓縮包后先解壓到 2.3 里規(guī)劃好的目錄。解壓完不要急著加路徑先核對(duì)文件結(jié)構(gòu)# Windows 下在解壓目錄執(zhí)行列出兩層結(jié)構(gòu) tree /F /A . | more # macOS / Linux find . -maxdepth 2 -type f -name *.m | sort這兩條命令的目的是一樣的確認(rèn)主函數(shù)文件通常是plot_google_map.m這類(lèi)名字在根目錄還是子目錄。如果find結(jié)果里主函數(shù)在./src/下面那加路徑就要加到src而不是解壓根目錄。很多“函數(shù)找不到”的報(bào)錯(cuò)根源就是加錯(cuò)了一層。核對(duì)時(shí)順便看一眼有沒(méi)有README或示例腳本示例腳本里通常寫(xiě)著推薦的調(diào)用參數(shù)比憑空猜參數(shù)靠譜。3.2 加搜索路徑addpath 與 savepath 的區(qū)別要搞清確認(rèn)主函數(shù)位置后在 MATLAB 命令行加路徑% 把工具目錄加入當(dāng)前會(huì)話搜索路徑 toolDir D:\matlab_tools\google_map\src; % 換成你的實(shí)際路徑 addpath(toolDir); % 確認(rèn)主函數(shù)已可見(jiàn) assert(exist(plot_google_map,file) 2, 主函數(shù)仍不可見(jiàn)檢查路徑層級(jí)); % 把路徑持久化下次啟動(dòng)仍生效 savepath;addpath只對(duì)當(dāng)前會(huì)話生效關(guān)掉 MATLAB 就沒(méi)了savepath把當(dāng)前路徑寫(xiě)進(jìn)pathdef.m下次啟動(dòng)自動(dòng)加載。這里有個(gè)取舍savepath方便但如果路徑指向的目錄后來(lái)被移動(dòng)或刪除MATLAB 啟動(dòng)時(shí)會(huì)彈警告嚴(yán)重的會(huì)導(dǎo)致啟動(dòng)變慢。我的習(xí)慣是開(kāi)發(fā)階段只用addpath確認(rèn)穩(wěn)定后再savepath并且把工具目錄固定在一個(gè)不輕易挪動(dòng)的位置。中間那句assert是給自己留的后悔藥加完路徑立刻驗(yàn)證別等到畫(huà)圖時(shí)才報(bào)錯(cuò)。如果路徑里有中文或空格Windows 下偶爾會(huì)出現(xiàn)addpath成功但函數(shù)加載失敗的情況。常見(jiàn)做法是把工具目錄放在純英文、無(wú)空格的路徑下比如D:\matlab_tools\google_map別放在“桌面\新建文件夾”這種位置。這不是玄學(xué)是 MATLAB 對(duì)含空格路徑的解析在部分版本上確實(shí)不穩(wěn)。3.3 寫(xiě)一個(gè)啟動(dòng)初始化腳本把路徑和參數(shù)固化下來(lái)每次開(kāi) MATLAB 手動(dòng)addpath太啰嗦我一般會(huì)在工具目錄下寫(xiě)一個(gè)setup_google_map.m把路徑、超時(shí)、默認(rèn)縮放級(jí)別這些一次性配好function setup_google_map() % 初始化谷歌地圖工具環(huán)境路徑、請(qǐng)求超時(shí)、默認(rèn)參數(shù) toolDir fileparts(mfilename(fullpath)); % 腳本所在目錄 addpath(toolDir); % 設(shè)置全局請(qǐng)求超時(shí)避免網(wǎng)絡(luò)慢時(shí)長(zhǎng)時(shí)間卡住 setpref(google_map,timeout,10); % 單位秒按網(wǎng)絡(luò)情況調(diào) % 默認(rèn)地圖類(lèi)型與縮放級(jí)別可在調(diào)用時(shí)覆蓋 setpref(google_map,maptype,roadmap); setpref(google_map,zoom,12); fprintf(谷歌地圖工具已初始化目錄%s\n, toolDir); endfileparts(mfilename(fullpath))拿到腳本自身所在目錄這樣腳本跟著工具目錄走換機(jī)器不用改路徑。setpref把超時(shí)和默認(rèn)參數(shù)存進(jìn) MATLAB 的偏好設(shè)置主函數(shù)里用getpref讀好處是調(diào)用時(shí)不用每次傳一堆參數(shù)壞處是偏好設(shè)置是全局的多項(xiàng)目共用時(shí)要記得在調(diào)用處顯式覆蓋。超時(shí)設(shè) 10 秒是我在普通寬帶下的經(jīng)驗(yàn)值網(wǎng)絡(luò)差可以調(diào)到 20但別設(shè)太大否則請(qǐng)求失敗時(shí)界面像卡死一樣。4. 配置參數(shù)地圖類(lèi)型、縮放級(jí)別與請(qǐng)求選項(xiàng)4.1 地圖類(lèi)型與縮放級(jí)別參數(shù)怎么傳、邊界在哪工具的主函數(shù)一般接受鍵值對(duì)參數(shù)常見(jiàn)的有地圖類(lèi)型、縮放級(jí)別、中心點(diǎn)經(jīng)緯度。調(diào)用形式大致如下% 在指定經(jīng)緯度范圍繪制谷歌地圖底圖 latLim [39.85, 40.05]; % 緯度范圍南到北 lonLim [116.25, 116.50]; % 經(jīng)度范圍西到東 plot_google_map(maptype,satellite, ... % 衛(wèi)星圖可選 roadmap/terrain zoom,14, ... % 縮放級(jí)別越大越清晰 latlim,latLim, ... lonlim,lonLim);maptype決定底圖樣式roadmap是路網(wǎng)圖satellite是衛(wèi)星影像terrain是地形圖按用途選。zoom是縮放級(jí)別數(shù)值越大瓦片越細(xì)但請(qǐng)求次數(shù)也越多14 到 16 在城市尺度夠用再大就要注意請(qǐng)求頻率。latlim和lonlim是經(jīng)緯度范圍順序是[最小, 最大]寫(xiě)反了會(huì)得到空白圖這是新手最常犯的參數(shù)錯(cuò)誤之一。參數(shù)名在不同版本的工具里可能略有差異以你解壓目錄里示例腳本的寫(xiě)法為準(zhǔn)別照搬網(wǎng)上的舊寫(xiě)法。4.2 請(qǐng)求選項(xiàng)超時(shí)、重試與請(qǐng)求頭網(wǎng)絡(luò)請(qǐng)求這塊工具內(nèi)部一般用weboptions組裝請(qǐng)求。如果你的版本支持可以在調(diào)用前設(shè)好超時(shí)和重試% 構(gòu)造請(qǐng)求選項(xiàng)超時(shí) 10 秒失敗重試 2 次 opts weboptions(Timeout, 10, ... ContentType, json, ... RequestMethod, get); % 部分版本支持重試寫(xiě)法以實(shí)際函數(shù)簽名為準(zhǔn) % opts weboptions(Timeout,10,Retry,2);Timeout是單次請(qǐng)求的超時(shí)秒數(shù)ContentType告訴 MATLAB 按 JSON 解析返回體RequestMethod固定為 GET。重試參數(shù)在不同 MATLAB 版本里支持程度不一樣R2020b 之后部分函數(shù)才認(rèn)Retry老版本沒(méi)有就靠外層try/catch加循環(huán)兜底。我一般會(huì)在批量出圖前先單張?jiān)囈淮未_認(rèn)請(qǐng)求通再跑循環(huán)避免幾十張圖一起超時(shí)把時(shí)間全耗掉。4.3 批量出圖時(shí)的頻率控制pause 不是可有可無(wú)批量畫(huà)多張圖時(shí)連續(xù)請(qǐng)求很容易觸發(fā)服務(wù)端的頻率限制表現(xiàn)為部分圖空白或返回錯(cuò)誤碼。常見(jiàn)做法是在每次請(qǐng)求之間加一個(gè)短暫停for k 1:numel(tileList) plot_google_map(maptype,roadmap,zoom,13, ... latlim,tileList(k).lat, ... lonlim,tileList(k).lon); pause(0.5); % 間隔 0.5 秒降低請(qǐng)求頻率 endpause(0.5)看著不起眼但批量任務(wù)里是保命的。間隔設(shè)多少取決于你的請(qǐng)求量和網(wǎng)絡(luò)狀況單張調(diào)試可以不加幾十張以上建議 0.3 到 1 秒。這個(gè)參數(shù)沒(méi)有標(biāo)準(zhǔn)答案跑一批看有沒(méi)有空白圖有就加大間隔。別為了快把間隔設(shè)成 0最后返工重跑的時(shí)間遠(yuǎn)超省下的那點(diǎn)。5. 避坑與排查五條血淚記錄5.1 現(xiàn)象報(bào) Undefined function路徑加了也沒(méi)用原因多半是加錯(cuò)了層級(jí)。主函數(shù)在src子目錄你卻把解壓根目錄加進(jìn)了路徑MATLAB 在根目錄找不到同名函數(shù)。解決用which -all plot_google_map看 MATLAB 到底在哪些路徑找過(guò)對(duì)照f(shuō)ind結(jié)果確認(rèn)主函數(shù)真實(shí)位置把a(bǔ)ddpath指到那一層。加完立刻用exist驗(yàn)證別等畫(huà)圖時(shí)才暴露。5.2 現(xiàn)象圖出來(lái)了但底圖空白只有坐標(biāo)軸原因通常是經(jīng)緯度范圍寫(xiě)反或者zoom超出該區(qū)域支持的上限。latlim必須是[小, 大]寫(xiě)反后請(qǐng)求的瓦片范圍為空。解決先把范圍縮到很小一塊比如 0.01 度見(jiàn)方單張測(cè)試確認(rèn)能出圖再放大范圍zoom從 12 起步逐級(jí)往上加看哪一級(jí)開(kāi)始空白那就是該區(qū)域的上限。5.3 現(xiàn)象請(qǐng)求超時(shí)或證書(shū)錯(cuò)誤原因分兩種網(wǎng)絡(luò)本身不通或 MATLAB 的證書(shū)鏈沒(méi)跟上系統(tǒng)。先在瀏覽器打開(kāi)地圖頁(yè)面確認(rèn)能出圖排除網(wǎng)絡(luò)問(wèn)題瀏覽器能開(kāi)而 MATLAB 報(bào)證書(shū)錯(cuò)誤Linux 下設(shè)SSL_CERT_FILE指向系統(tǒng)證書(shū)包Windows 下檢查 MATLAB 代理設(shè)置是否與系統(tǒng)一致。解決后把Timeout調(diào)到 15 秒再試別用默認(rèn)的短超時(shí)硬扛。5.4 現(xiàn)象savepath 后每次啟動(dòng)彈路徑警告原因是保存的路徑里有目錄被移動(dòng)或刪除。savepath把路徑寫(xiě)死進(jìn)pathdef.m目錄一挪就報(bào)警。解決打開(kāi)pathdef.m用which pathdef定位刪掉失效條目或者干脆恢復(fù)默認(rèn)路徑后重新只加當(dāng)前有效的工具目錄。我的習(xí)慣是工具目錄固定不動(dòng)移動(dòng)前先rmpath再挪。5.5 現(xiàn)象批量出圖一半空白重跑又好了原因是請(qǐng)求頻率過(guò)高被限流或單次超時(shí)太短。解決請(qǐng)求間加pause(0.5)以上Timeout調(diào)到 10 到 15 秒外層包try/catch記錄失敗索引跑完統(tǒng)一補(bǔ)跑失敗的那幾張。別一次性重跑全部浪費(fèi)時(shí)間還容易再次觸發(fā)限流。6. 裝完怎么驗(yàn)證三張圖跑通才算數(shù)驗(yàn)證這套環(huán)境我不看“函數(shù)能調(diào)用”這種弱指標(biāo)直接出三張圖覆蓋路網(wǎng)、衛(wèi)星、地形三種底圖再疊一條模擬軌跡全過(guò)了才算裝好。第一張用默認(rèn)參數(shù)畫(huà)一小塊路網(wǎng)圖確認(rèn)基本請(qǐng)求通第二張換satellite并調(diào)高zoom確認(rèn)瓦片清晰度和縮放參數(shù)生效第三張疊一條經(jīng)緯度折線確認(rèn)底圖與數(shù)據(jù)坐標(biāo)系對(duì)齊。% 驗(yàn)證腳本三種底圖 一條模擬軌跡 lat [39.90, 39.92, 39.95, 39.93]; lon [116.30, 116.35, 116.38, 116.42]; figure; plot_google_map(maptype,roadmap,zoom,13, ... latlim,[39.88,39.97],lonlim,[116.28,116.44]); hold on; plot(lon, lat, r-, LineWidth, 2); % 疊加軌跡 hold off; title(路網(wǎng)底圖 軌跡); figure; plot_google_map(maptype,satellite,zoom,15, ... latlim,[39.88,39.97],lonlim,[116.28,116.44]); title(衛(wèi)星底圖); figure; plot_google_map(maptype,terrain,zoom,12, ... latlim,[39.88,39.97],lonlim,[116.28,116.44]); title(地形底圖);三張圖依次檢查路網(wǎng)圖里軌跡線是否落在合理位置衛(wèi)星圖瓦片有沒(méi)有拼接縫地形圖縮放是否正常。任何一張空白回到第 5 章對(duì)應(yīng)條目排查。三張都過(guò)再跑一次savepath后的重啟驗(yàn)證關(guān)掉 MATLAB 重開(kāi)直接跑驗(yàn)證腳本不手動(dòng)addpath也能出圖說(shuō)明路徑持久化生效。從那以后我每次裝這類(lèi)地圖工具都強(qiáng)制先跑這三張圖的驗(yàn)證腳本再交付不靠“應(yīng)該沒(méi)問(wèn)題”糊弄自己。環(huán)境這東西裝的時(shí)候多花十分鐘驗(yàn)證比事后翻兩小時(shí)日志劃算得多。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取