Places Aggregate API (舊稱 Places Insights API) 現已正式發布 (GA)。
Places Aggregate API 常見問題
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
API 是否有使用頻率限制?
Places Aggregate API 的預設頻率限制為每分鐘 1,200 次查詢。
TypeFilter 中的「included_primary_types」和「included_types」有何差異?
included_primary_types
:篩選指定類型為主要或主要類別的地點。這些地點也可能具有其他次要類型。
included_types
:篩選出類別包含指定類型的地點,不論是主要或次要類型皆可。
舉例來說,如果將 included_primary_types
設為 restaurant
,搜尋結果會傳回主要功能為供應餐點的場所;如果將 included_types
設為 restaurant
,搜尋結果會傳回供應餐點的場所,即使這些場所有其他主要類別,例如附有 cafe
的 museum
。
如要進一步瞭解,請參閱地點類型。
如何定義非圓形的自訂搜尋區域?
您可以使用多邊形定義自訂搜尋區域。請提供經緯度座標清單,以逆時針順序定義單一多邊形的頂點。第一個和最後一個座標必須相同,才能封閉多邊形。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-29 (世界標準時間)。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[],[],null,["# Places Aggregate API FAQ\n\nIs there a rate limit on the API?\n---------------------------------\n\nFor Places Aggregate API, there is a default rate limit of\n1,200 queries per minute.\n\nWhat is the difference between 'included_primary_types' and 'included_types' in the TypeFilter?\n-----------------------------------------------------------------------------------------------\n\n- `included_primary_types`: Filters for places where the specified types are their main or primary category. These places might also have other secondary types.\n- `included_types`: Filters for places that have the specified types as any of their categories, regardless of whether it's the primary or secondary type.\n\nFor example, a search using `included_primary_types` set to `restaurant` would\nreturn places whose primary function is to serve food, whereas `included_types`\nset to `restaurant` would return places that serve food even if they have\nanother primary category, such as a `museum` with a `cafe`.\n\nFor further reading, visit [Place Types](/maps/documentation/places/web-service/place-types).\n\nHow do I define a custom search area that isn't a circle?\n---------------------------------------------------------\n\nYou can define a custom search area using a polygon. Provide a list of latitude\nand longitude coordinates that define the vertices of a single polygon in a\ncounter-clockwise order. The first and last coordinates *must* be the same to\nclose the polygon."]]