Skip to Content
API 參考Google Maps

Google Maps

搜尋地點、取得詳細商家資訊，以及閱讀 Google Maps 評論。

  • 搜尋：依關鍵字尋找地點
  • 地點：取得詳細商家資訊（營業時間、照片、熱門時段等）
  • 評論：分頁瀏覽評論，支援排序
  • 透過 language 參數支援多語言

搜尋

GET /gmaps/places/search — 2 點數

搜尋 Google Maps 上符合條件的地點。

參數類型必填預設說明
qstring是—搜尋關鍵字（例如「東京咖啡店」）
languagestring否en語言代碼（例如 en、ja、zh-TW）
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 地點的詳細資訊。

參數類型必填預設說明
querystring是—地點名稱或完整 Google Maps 網址
languagestring否en語言代碼（例如 en、ja、zh-TW）
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,
  "reviewCount": 1691,
  "ratingDistribution": { "1": 148, "2": 49, "3": 116, "4": 341, "5": 1037 },
  "reviewHighlights": [
    "The service was fantastic and the staff was happy to engage.",
    "Best coffee I've ever had, the matcha latte was incredible."
  ],
  "description": "精品咖啡與糕點",
  "lat": 35.6595,
  "lng": 139.7004,
  "placeId": "ChIJ...",
  "visitDuration": "People typically spend 30 min to 1 hr here",
  "photos": ["https://lh3.googleusercontent.com/..."],
  "popularTimes": {
    "Monday": { "6": 0, "7": 15, "8": 30, "9": 50, "10": 65 },
    "Tuesday": { "6": 0, "7": 20, "8": 35, "9": 55, "10": 70 }
  },
  "currentPopularity": 65,
  "additionalInfo": {
    "Service options": [{ "Takeout": true }, { "Dine-in": true }],
    "Accessibility": [{ "Wheelchair accessible entrance": true }],
    "Amenities": [{ "Wi-Fi": true }, { "Restroom": true }]
  },
  "businessStatus": "Open",
  "peopleAlsoSearch": [
    { "name": "Starbucks Reserve", "rating": 4.3, "reviewCount": 2100 }
  ]
}

評論

GET /gmaps/places/reviews — 5 點數

取得 Google Maps 地點的評論（每頁 10 筆，支援分頁）。

參數類型必填預設說明
querystring是—地點名稱或完整 Google Maps 網址
sortstring否relevant排序方式：relevant、newest、highest、lowest
pageTokenstring否—上一次回應的分頁 token
languagestring否en語言代碼（例如 en、ja、zh-TW）
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/gmaps/places/reviews?query=Blue+Bottle+Coffee+Tokyo&sort=newest&language=zh-TW"

回應

{
  "reviews": [
    {
      "reviewId": "ChZDSU...",
      "author": {
        "name": "John Doe",
        "profileUrl": "https://www.google.com/maps/contrib/...",
        "id": "123456789"
      },
      "rating": 5,
      "text": "Amazing place! The view from the top is breathtaking.",
      "language": "en",
      "publishedTime": "1772886371029154",
      "images": [{ "url": "https://lh3.googleusercontent.com/..." }],
      "ownerResponse": null
    }
  ],
  "totalReviews": 10,
  "nextPageToken": "CAESY0..."
}
Last updated on
LinkedInTrustpilot