安德里亞·格蘭迪Andrea Grandi——軟件開發(fā)工程師1. GitHub2. Mastodon3. 領(lǐng)英LinkedIn4. RSS1. 主頁(yè)2. 關(guān)于3. 履歷在ko-fi.com上請(qǐng)我喝杯咖啡開發(fā) 社區(qū) 個(gè)人觀點(diǎn)為何“圖書角Book Corners”不會(huì)將貢獻(xiàn)同步回開放街圖OpenStreetMap原本希望“圖書角”能將新提交的公共書架信息反饋給開放街圖但研究運(yùn)營(yíng)和社區(qū)要求后決定不實(shí)施該功能。2026年7月31日一個(gè)看似不錯(cuò)的功能介紹 圖書角 時(shí)提到其初始數(shù)據(jù)大多來(lái)自 開放街圖開放街圖為項(xiàng)目提供了很好的起點(diǎn)全球已有數(shù)千個(gè)公共書架被標(biāo)注在上面?！皥D書角”接受用戶直接提交新的圖書館信息用戶提交位置和照片經(jīng)審核后貢獻(xiàn)會(huì)公開。所以當(dāng)開放街圖缺少這些提交信息時(shí)“圖書角”將其反饋回去看似理所應(yīng)當(dāng)。設(shè)想的工作流程很謹(jǐn)慎- 提交圖書館信息的用戶需明確同意進(jìn)行反饋。- 管理員首先對(duì)圖書館信息進(jìn)行審核。- “圖書角”會(huì)在開放街圖中搜索可能的重復(fù)信息。- 管理員會(huì)預(yù)覽要發(fā)送的確切數(shù)據(jù)。- 直到管理員確認(rèn)后才會(huì)進(jìn)行寫入操作。從軟件開發(fā)角度看這似乎是易于管理的集成添加用戶同意選項(xiàng)、跟蹤貢獻(xiàn)狀態(tài)、構(gòu)建預(yù)覽、與開放街圖進(jìn)行身份驗(yàn)證并通過其API創(chuàng)建新的地理特征。其實(shí)編寫代碼并非最困難的部分。貢獻(xiàn)數(shù)據(jù)并非僅僅調(diào)用API那么簡(jiǎn)單認(rèn)真研究具體實(shí)現(xiàn)時(shí)發(fā)現(xiàn)調(diào)用API寫入數(shù)據(jù)只是工作的一小部分。由于信息來(lái)自“圖書角”數(shù)據(jù)庫(kù)開放街圖可能將其視為外部數(shù)據(jù)導(dǎo)入。而且盡管每個(gè)圖書館信息都要經(jīng)過管理員審核但因是軟件準(zhǔn)備和提交更改也可能符合腳本輔助或自動(dòng)編輯的規(guī)則。嚴(yán)格遵循 開放街圖導(dǎo)入指南 和 自動(dòng)編輯行為準(zhǔn)則所需不止一個(gè)專用賬戶和OAuth令牌。首次正式貢獻(xiàn)前需要- 創(chuàng)建并維護(hù)一個(gè)專用的開放街圖導(dǎo)入賬戶。- 在開放街圖維基上發(fā)布詳細(xì)的導(dǎo)入計(jì)劃。- 記錄數(shù)據(jù)源、許可協(xié)議、字段映射、重復(fù)檢測(cè)、使用的軟件、質(zhì)量檢查、變更集策略以及回滾程序。- 在開放街圖社區(qū)論壇上提出提案。- 聯(lián)系受這些貢獻(xiàn)影響的相關(guān)本地社區(qū)。- 等待審核期結(jié)束并解決所有問題。- 保留導(dǎo)入賬戶、計(jì)劃、討論和變更集之間的永久鏈接。- 為未來(lái)的問題或投訴提供聯(lián)系方式和退出途徑。此外還有重要的許可問題。用戶同意將圖書館信息發(fā)送到開放街圖不意味著就自動(dòng)擁有以符合開放街圖要求的條款發(fā)布這些事實(shí)信息的明確權(quán)利。面向用戶的說(shuō)明和同意書需要涵蓋這一區(qū)別包括確認(rèn)信息并非來(lái)自不兼容的數(shù)據(jù)源。這些要求并非一次性表格填寫后就可置之不理意味著要對(duì)賬戶、記錄的流程、社區(qū)反饋、失敗情況以及可能的回滾操作承擔(dān)持續(xù)的責(zé)任。理解規(guī)則存在的原因開放街圖是共享的全球數(shù)據(jù)庫(kù)一次糟糕的導(dǎo)入可能造成數(shù)千個(gè)重復(fù)信息覆蓋更準(zhǔn)確的本地知識(shí)或引入一旦被其他人編輯就難以消除的錯(cuò)誤。從這個(gè)角度看要求提供文檔、明確許可協(xié)議、處理重復(fù)信息、明確責(zé)任人和進(jìn)行社區(qū)討論是合理的。開放街圖社區(qū)必須保護(hù)地圖數(shù)據(jù)的質(zhì)量良好的意愿并不能保證數(shù)據(jù)的質(zhì)量?！皥D書角”本身也受益于這種數(shù)據(jù)質(zhì)量。如果期望開放街圖在沒有保障措施的情況下接受外部服務(wù)的更改那將是虛偽的。與此同時(shí)這個(gè)過程確實(shí)需要付出成本。它要求一個(gè)小項(xiàng)目不僅要成為API客戶端還要成為有文檔記錄的導(dǎo)入項(xiàng)目的運(yùn)營(yíng)者。這對(duì)于導(dǎo)入大型數(shù)據(jù)集的組織來(lái)說(shuō)可能合適但對(duì)于僅旨在將少數(shù)經(jīng)過仔細(xì)審核的公共書架信息反饋給公共數(shù)據(jù)庫(kù)的低流量功能來(lái)說(shuō)是相當(dāng)大的承諾。運(yùn)營(yíng)成本超過了功能價(jià)值“圖書角”的目標(biāo)很簡(jiǎn)單幫助人們發(fā)現(xiàn)小型免費(fèi)圖書館并與他人分享新的圖書館信息。運(yùn)營(yíng)一個(gè)向開放街圖貢獻(xiàn)數(shù)據(jù)的流程并非其核心目標(biāo)。這將需要添加憑證管理、生產(chǎn)保障措施、審計(jì)和對(duì)賬代碼、社區(qū)流程、許可工作以及長(zhǎng)期支持義務(wù)。雖然每個(gè)部分單獨(dú)看都有合理性但綜合起來(lái)這個(gè)功能比最初設(shè)想的要復(fù)雜得多。此外還有機(jī)會(huì)成本?；ㄔ谶\(yùn)營(yíng)這個(gè)集成上的時(shí)間就不能用于改進(jìn)圖書館發(fā)現(xiàn)功能、審核流程、照片展示、可訪問性、翻譯或移動(dòng)應(yīng)用體驗(yàn)。這些改進(jìn)能直接幫助“圖書角”的用戶而且對(duì)于一個(gè)小項(xiàng)目來(lái)說(shuō)更容易維持。起初認(rèn)為將數(shù)據(jù)反饋回去是既友好又公平的事情。但深入研究后意識(shí)到僅憑善意不足以承擔(dān)一個(gè)無(wú)期限的運(yùn)營(yíng)責(zé)任。最終決策決定無(wú)限期擱置向開放街圖寫回?cái)?shù)據(jù)功能的開發(fā)?！皥D書角”將繼續(xù)注明從開放街圖導(dǎo)入的記錄來(lái)源并且不會(huì)將從開放街圖導(dǎo)入的圖書館信息當(dāng)作新信息再次提交。但用戶直接貢獻(xiàn)給“圖書角”的圖書館信息將保留在“圖書角”中該服務(wù)不會(huì)自動(dòng)或手動(dòng)在開放街圖中創(chuàng)建對(duì)應(yīng)的地理特征。目前“圖書角”沒有向開放街圖正式環(huán)境寫入數(shù)據(jù)的功能因此暫停這項(xiàng)工作無(wú)需禁用或遷移現(xiàn)有的集成。如果未來(lái)有真正輕量級(jí)的工作流程出現(xiàn)或者“圖書角”的貢獻(xiàn)規(guī)模和價(jià)值最終能夠證明這個(gè)流程的合理性可能會(huì)重新考慮這個(gè)決定。另一種可能是采用用戶驅(qū)動(dòng)的工作流程在現(xiàn)有的開放街圖編輯器中打開提議的地理特征但這仍需要與社區(qū)進(jìn)行討論而不能將其視為繞過規(guī)則的方法。目前負(fù)責(zé)任的選擇是不開發(fā)和運(yùn)營(yíng)一個(gè)沒有信心能夠妥善支持的功能。有時(shí)不做功能才是正確的選擇人們往往容易將實(shí)現(xiàn)決策單純視為技術(shù)問題API能否實(shí)現(xiàn)、應(yīng)用程序能否進(jìn)行身份驗(yàn)證、代碼能否避免重復(fù)等。這次經(jīng)歷提醒外部集成還涉及組織和社會(huì)契約。有時(shí)候這些契約的成本比代碼本身還要高。在部署之前發(fā)現(xiàn)這一點(diǎn)是有價(jià)值的盡管結(jié)果可能令人失望。仍然認(rèn)為將數(shù)據(jù)反饋給共享的開源項(xiàng)目是有價(jià)值的也理解開放街圖為何如此謹(jǐn)慎地保護(hù)其數(shù)據(jù)庫(kù)。但就目前的“圖書角”而言收益和責(zé)任之間的平衡并不理想。所以這是選擇不推出的一個(gè)功能。如果你喜歡這篇文章并想表達(dá)支持可以點(diǎn)擊下面的按鈕請(qǐng)我喝杯咖啡。你的支持哪怕只是一個(gè)小小的舉動(dòng)都意義重大會(huì)激勵(lì)我繼續(xù)在博客上撰寫和分享更多文章 ??在ko-fi.com上請(qǐng)我喝杯咖啡 圖書角Book - Corners 開放街圖Openstreetmap 開放數(shù)據(jù)Open - Data 開源Open - Source 社區(qū)Community 產(chǎn)品決策Product - Decisions相關(guān)內(nèi)容- 圖書角 - 發(fā)現(xiàn)并分享全球小型免費(fèi)圖書館- 發(fā)布支持代理技能的Obsidian會(huì)議記錄同步工具- 宣布mcp - wire 0.3.0版本發(fā)布- 為何要為已有上下文命令的CLI添加代理技能- 發(fā)布mb - cli 0.3.0用于Metabase API的只讀CLI工具