進一步瞭解類型篩選器

在 Places Aggregate API 中，類型篩選器可讓您選擇要在回應中納入或排除哪些類型的地點，藉此縮小搜尋範圍。您可以建立想找和不想找的類型清單，包括地點的主要類別和其他詳細資料。這樣一來，您就能建立特定搜尋，找出確切的地點。

系統提供超過 200 種地點類型。如需 Places Aggregate API 支援的完整清單，請參閱 Places API (新版) 的「地點類型」下方的「表 A」。

地點類型的運作方式

一個地點可以有多個地點類型：

• 地點只能有一個 主要類型，反映其主要功能。不過，有時地點可能未指定主要類型。

• 一個地點可以有一或多個 次要類型。次要類型是適用於地點的其他類別，可提供地點特徵和服務的補充資訊。

舉例來說，某個地點可能會將主要類型指定為 restaurant，但由於該地點也提供酒吧和餐飲服務，因此也可以將次要地點類型指定為 bar, food 和 establishment。

依類型篩選

如要依主要類型篩選地點，請在要求中使用 includedPrimaryTypes 和 excludedPrimaryTypes。篩選器只會套用至地點的主要類型。舉例來說，restaurant 的 includedPrimaryTypes 篩選器只會傳回主要功能為餐廳的地點。

如要依主要和次要類型篩選地點，請在要求中使用 includedTypes 和 excludedTypes。這項篩選條件適用於這兩種類型。舉例來說，includedTypes 的 bar 會傳回主要或次要類型為 bar 的地點。

重要事項：使用多個篩選器時，請務必瞭解篩選器之間的互動方式。具體來說，系統會使用「或」邏輯評估同一個篩選器中的地點，並使用「且」邏輯評估不同篩選器中的地點。

• 篩選器內 (OR 邏輯)：舉例來說，includedTypes: restaurant, bar 表示地點可以是 restaurant 或 bar。
• 跨篩選器 (AND 邏輯)：必須同時滿足所有指定的篩選條件。也就是說，每項篩選條件都會為查詢新增一層限制，只有符合「所有」條件的地點才會納入結果。

舉例來說，如果您設定 includedTypes: restaurant, bar 和 excludedTypes: hotel，includedTypes 篩選器會先選取所有歸類為 restaurant 或 bar 的地點。其次，excludedTypes篩選器會從選取範圍中移除所有歸類為hotel的地點。因此，查詢會傳回 restaurant 或 bar，但前提是這些地點的任何類型 (主要或次要) 都未分類為 hotel。