goplaces

goplaces 是一款專業的 CLI 工具，旨在簡化 Google Places API (New) 的複雜端點操作，使其適應終端機作業流程。專為需要進行地理空間查詢、驗證地點數據或自動化挖掘地點資訊的開發者與進階用戶而設計。無論您是在進行在地市場研究、為應用程式收集場地資訊，還是編寫自動化搜尋腳本，goplaces 都能提供與 Google 龐大地點資料庫互動的穩定且精簡的介面。

• 執行基於文字的地點搜尋，並可精確篩選營業狀態、評分及結果數量。

• 將非結構化的地址或地點名稱解析為具體的 Place ID 及地理座標。

• 擷取完整的地點詳細資訊，包含營業時間、地址元件及選擇性的客戶評論內容。

• 支援基於特定經緯度座標及自訂半徑的地理偏差（Bias）搜尋。

• 提供人類易讀的終端機輸出模式或原始 JSON 格式，方便整合至自動化工具、資料管道及 shell 腳本中。

• 支援透過分頁標記（Page Token）進行分頁，以高效處理大規模的搜尋結果。

• 操作需具備有效的 GOOGLE_PLACES_API_KEY 環境變數。

• 支援透過 GOOGLE_PLACES_BASE_URL 設定進行代理或測試。

• 可透過 --no-color 參數或 NO_COLOR 環境變數停用 ANSI 色碼，確保在 CI/CD 日誌及非互動式環境中的相容性。

• 處理標準 API 價格等級映射 (0-4)，並嚴格遵守 Google Places API 文件規定的類型篩選限制。

• 使用者可透過 macOS 或 Linux 上的 Homebrew 輕鬆安裝，使其成為任何命令列工具組中便攜且強大的延伸元件。