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.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 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."]]