goplaces

• 您需要一個代理來尋找附近的商家或景點 — 例如「1 公里內營業中、評分 4 顆星以上的咖啡廳」
• 您想將人類可讀的地點名稱（例如「英國倫敦 Soho」）解析為 Google Place ID，以供後續 API 呼叫使用
• 您需要透過 JSON 輸出將結構化的地點詳細資訊（營業時間、地址、評論）傳送至腳本或工作流程
• 您的代理必須依據營業狀態、價格等級、類型或地理半徑來篩選結果

• 您沒有 Google Places API 金鑰或無法取得金鑰——沒有金鑰，goplaces 將無法運作
• 您需要地圖渲染、路線指引或路徑規劃——此技能僅提供查詢功能，並非完整的 Maps SDK
• 您需要大量或高流量的地點資料；標準 Google Places API 配額與計費規則仍然適用

使用自然語言進行地點搜尋，並支援以下篩選條件：目前營業中狀態、最低評分、價格等級、類型及結果數量限制。範例：goplaces search "coffee" --open-now --min-rating 4 --limit 5。

將搜尋結果偏移至特定的經緯度位置，並將結果限制在可設定的公尺半徑範圍內，使具有位置感知能力的查詢更加精確且切題。

使用 resolve 指令，將人類可讀的地點名稱（例如「Soho, London」）轉換為一個或多個 Google Place ID，讓後續的詳細資料查詢無需手動搜尋 ID。

透過 goplaces details <place_id> --reviews 獲取任何地點 ID 的完整詳細資訊，包括評論。非常適合以權威的地點資料豐富代理人的回應內容。

預設輸出人性化、帶有 ANSI 色彩的文字以提升可讀性，或使用 --json 切換為乾淨的 JSON 格式，以便在腳本及自動化流程中進行可靠的解析。可透過 --no-color 或環境變數 NO_COLOR 來停用色彩輸出。

透過 --page-token 支援多頁結果集，讓代理程式能夠迭代瀏覽超出預設頁面大小的大型結果清單。

一個協助使用者規劃夜間外出的代理人，可以在特定社區內搜尋評分高且營業中的餐廳，依料理類型和價位進行篩選，然後以易讀的格式呈現最佳結果。

資料管道代理人將模糊的地點字串（例如：城市區域、地標）解析為具有權威性的 Google 地點 ID，這些 ID 隨後會傳遞至其他 API 呼叫，或儲存於資料庫中。

當代理人在研究某個地點時，可直接透過 goplaces details <id> --reviews 取得其 Google Places 評論，無需使用瀏覽器即可彙整情感傾向或擷取特定意見回饋。

批次自動化腳本使用 --json 輸出，以結構化地點資料（地址、評分、營業時間）豐富商家名稱清單，並將結果饋送至下游處理工具。