Google Maps API
搜尋地點並從 Google Maps 取得詳細商家資訊。
- 使用 Playwright 瀏覽器自動化進行可靠的資料擷取
- 支援地點搜尋與詳細地點資訊查詢
- 透過
language參數支援多語言
搜尋
GET /gmaps/places/search — 2 點數
搜尋 Google Maps 上符合條件的地點。
| 參數 | 類型 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
q | string | 是 | — | 搜尋關鍵字（例如「東京咖啡店」） |
language | string | 否 | en | 語言代碼（例如 en、ja、zh-TW） |
cURL
curl -H "x-api-key: sk_byc_xxx" \
"https://api.bycrawl.com/gmaps/places/search?q=coffee+shops+in+Tokyo&language=zh-TW"回應
{
"query": "東京咖啡店",
"resultType": "list",
"places": [
{
"name": "Blue Bottle Coffee",
"category": "咖啡廳",
"address": "日本東京都澀谷區 1-2-3",
"website": "https://bluebottlecoffee.com",
"rating": 4.5,
"description": "精品咖啡與糕點",
"lat": 35.6595,
"lng": 139.7004,
"placeId": "ChIJ...",
"photoCount": 500
}
],
"totalResults": 20
}地點
GET /gmaps/places — 15 點數
取得 Google Maps 地點的詳細資訊。
| 參數 | 類型 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
query | string | 是 | — | 地點名稱或完整 Google Maps 網址 |
language | string | 否 | en | 語言代碼（例如 en、ja、zh-TW） |
cURL
curl -H "x-api-key: sk_byc_xxx" \
"https://api.bycrawl.com/gmaps/places?query=Blue+Bottle+Coffee+Tokyo&language=zh-TW"回應
{
"name": "Blue Bottle Coffee",
"category": "咖啡廳",
"address": "日本東京都澀谷區 1-2-3",
"website": "https://bluebottlecoffee.com",
"phone": "+81 3-1234-5678",
"rating": 4.5,
"hours": "星期一 8AM-6PM ...",
"lat": 35.6595,
"lng": 139.7004,
"priceLevel": "Price: Moderate",
"url": "https://www.google.com/maps/place/Blue+Bottle+Coffee/..."
}