The Places Aggregate API, previously known as Places Insights API, is now generally available (GA).
Places Aggregate API FAQ
Stay organized with collections
Save and categorize content based on your preferences.
Is there a rate limit on the API?
For Places Aggregate API, there is a default rate limit of
1,200 queries per minute.
What is the difference between 'included_primary_types' and 'included_types' in the TypeFilter?
included_primary_types: Filters for places where the specified types are
their main or primary category. These places might also have other secondary
types.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.
For example, a search using included_primary_types set to restaurant would
return places whose primary function is to serve food, whereas included_types
set to restaurant would return places that serve food even if they have
another primary category, such as a museum with a cafe.
For further reading, visit Place Types.
How do I define a custom search area that isn't a circle?
You can define a custom search area using a polygon. Provide a list of latitude
and longitude coordinates that define the vertices of a single polygon in a
counter-clockwise order. The first and last coordinates must be the same to
close the polygon.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],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."]]
