This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions.

Places Insights API FAQ

Is there a rate limit on the API?

For Places Insights API, there is a default rate limit of 600 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.