dekart-xyz/geosql

解決的問題

GeoSQL 提供了一種讓資料科學家與分析師使用自然語言執行複雜地理空間分析的方法。它消除了在 PostGIS、BigQuery、Snowflake 和 Wherobots 等不同資料倉儲中手動撰寫空間 SQL 查詢的需要，同時確保生成的查詢在成本效益與幾何準確性方面皆有保障。

工作原理

GeoSQL 作為 AI 代理（如 Claude Code、GitHub Copilot 等）的技能進行整合。其運作過程包含一個地圖渲染步驟的循環：

1. 探索：代理探索實際的資料倉儲元資料，以理解資料表結構與欄位。
2. SQL 產生：根據所使用的特定資料庫引擎，產生客製化的空間 SQL。
3. 成本控管：針對 BigQuery，執行預執行以估算成本，並自動重寫超過 10 GiB 計費上限的查詢。
4. 驗證：根據領域知識驗證幾何資料（例如檢查總面積或長度）。
5. 地圖反饋：透過 Dekart 渲染結果，以視覺化方式檢視地圖，修正文字處理過程中容易遺漏的幾何錯誤。

適用對象

在不同雲端資料倉儲中處理地理空間資料，並希望利用 AI 代理加速空間分析工作流程的資料科學家與分析師。

主要特色

• 地圖閉環反饋：利用渲染地圖的視覺反饋自我修正幾何錯誤，實現 4 倍效能提升。
• 多資料倉儲支援：相容於 PostGIS、BigQuery、Snowflake 與 Wherobots。
• 本地優先：完全本地運行或自架設，無需 SaaS 帳戶。
• 成本控制：內建計費上限與 BigQuery 的自動查詢重寫功能。
• 安全：使用本地 CLI 認證，確保資料倉儲憑證不會傳送給代理。