Places Insights API FAQ

Is there a rate limit on the API?

For Places Insights 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.