範例

本節說明對 Places Insights API 發出的一系列要求範例。

如要使用 computeInsights，請使用下列格式提交 HTTP POST 要求：

https://areainsights.googleapis.com/v1:computeInsights

傳回圓形內的地點

傳回倫敦特拉法加廣場 (Trafalgar Square) 方圓 200 公尺內的所有餐廳。

  • 搜尋區域是以特定經緯度為中心的圓圈， 這個圓形的半徑為 200 公尺，也就是 搜尋區域
  • 要求的地點類型是餐廳，且系統會使用 type_filters內，included_types。
  • 請使用 INSIGHTS_COUNT 要求計數，並使用 INSIGHTS_PLACES 要求地點 ID。
{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

排除地點類型

您也可以從計數中排除地點類型。

下列要求與第一個範例相同，但新增了 excluded_types至 type_filters。您可以使用字串或陣列 included_types 和 excluded_types 的字串。

這個範例從以下位置排除了 cafe 和 bakery 兩種地點類型： 共 restaurant 個。

{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "location_filter": {
            "circle": {
                "lat_lng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "type_filter": {
            "included_types": "restaurant",
            "excluded_types": [
                "cafe",
                "bakery"
            ]
        }
    }
}

使用主要類型

這個範例會修改第一個範例的要求，只納入計數中 primaryType 為 restaurant 的場所。

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_primary_types": "restaurant" }
  }
}

自訂多邊形

這個範例說明如何使用自訂多邊形來定義搜尋方式 請注意，指定 INSIGHTS_PLACES 會將搜尋範圍限制在小範圍內，最多可傳回 100 個地點 ID。如果是較大的區域，請使用 INSIGHTS_COUNT 會略過這項限制，因此服務不需要 則會傳回個別地點 ID。

如前所述，使用的地點類型為 restaurant。這個範例也導入了 另外三種篩選器：

  • operating_status：這個範例只會計算營運地點。
  • price_level：這個範例只會計算價格低廉和中價位的地點。
  • rating_filter：這個範例只會計算評分介於 4.0 和 5.0 之間的地點。
{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "location_filter": {
            "custom_area": {
                "polygon": {
                    "coordinates": [
                        { "latitude": 37.776, "longitude": -122.666 },
                        { "latitude": 37.130, "longitude": -121.898 },
                        { "latitude": 37.326, "longitude": -121.598 },
                        { "latitude": 37.912, "longitude": -122.247 },
                        { "latitude": 37.776, "longitude": -122.666 }
                    ]
                }
            }
        },
        "type_filter": {
            "included_types": "restaurant"
        },
        "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ],
        "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 }
    }
}

地理區域

本範例使用地理區域地點 ID 來設定搜尋區域。這些地點 ID 包括地點的幾何圖形，例如鄉鎮或城市。 這裡使用的地點 ID 是 ChIJiQHsW0m3j4ARm69rRkrUF3w，與 加州山景城。

將地點 ID 傳送至 Places Insights API 會將搜尋區域設為邊界 地理區域。地點 ID 會透過 place 傳遞，格式為 places/<place_ID>。

您可以透過下列任一方式取得地理區域地點 ID：

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}