This product or feature is in Experimental (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. Sign up to test Places Insights!

Filter parameters

You can apply filters to places count functions using the parameters described in the table below. Note that the required parameters differ for each function:

PLACES_COUNT: requires geography
PLACES_COUNT_PER_TYPE: requires geography and type
PLACES_COUNT_PER_GEO: requires geographies
PLACES_COUNT_PER_H3: requires geography and h3_resolution

The function returns an invalid argument error if the filter name and value are not specified according to the requirements below.

Filter Name	Description	Type	Supported Values
`geography`	For `PLACES_COUNT`, `PLACES_COUNT_PER_TYPE`, and `PLACES_COUNT_PER_H3` Specifies an area to search. Any type of `GEOGRAPHY` is supported such as `Point`, `LineString`, and `Polygon`. You can use the `geography` parameter in combination with `geography_radius` to add a buffer to your search area. A minimum search area of 40.0 meters by 40.0 meters (1600 m²) is enforced. If you specify a search area under this limit the function returns an invalid argument error.	`GEOGRAPHY`	Any type of `GEOGRAPHY`.
`geographies`	For `PLACES_COUNT_PER_GEO` only Specifies a list of areas to search. Any type of `GEOGRAPHY` is supported such as `Point`, `LineString`, and `Polygon`. You can use the `geographies` parameter in combination with `geography_radius` to add a buffer to your search area. The buffer is added to all geographies specified. A minimum search area of 40.0 meters by 40.0 meters (1600 m²) is enforced. If you specify a search area under this limit the function returns an invalid argument error.	`ARRAY<GEOGRAPHY>`	Any type of `GEOGRAPHY`.
`geography_radius`	Adds a radius or buffer, in meters, to the specified geography. The default value is 0. The specified value must define a minimum search area of 40.0 meters by 40.0 meters (1600 m²). For example, for a `Point` geography, the minimum radius is therefore 23 meters.	`INT64`	Minimum is 0.
`h3_resolution`	For `PLACES_COUNT_PER_H3` only The H3 resolution used to aggregate the count of places into H3 cells.	`INT64`	Between 0 and 8.
`types`	Specifies the places types to consider. Each place contains a set of places types, for example `"restaurant"` and `"cafe"`. If no types are specified, all place types are considered in the result.	`ARRAY<STRING>`	For the complete list of possible values, see Place types. Example: `["restaurant", "cafe", "bar"]`
`primary_types`	Specifies the primary types to consider. A place can only have a single primary type which is the type that best describes the location. If no primary types are specified, all place primary types are considered in the result.	`ARRAY<STRING>`	For the complete list of possible values, see Place types. Example: `["restaurant", "cafe", "bar"]`
`min_rating`	Specifies the minimum place rating to consider. A Places rating is based on user reviews of the place and has a range between 1.0 and 5.0 If you specify a rating outside this range, the function returns an invalid argument error.	`FLOAT`	Between 1.0 and 5.0.
`max_rating`	Specifies the maximum place rating to consider. A Places rating is based on user reviews of the place and has a range between 1.0 and 5.0 If you specify a rating outside this range, the function returns an invalid argument error.	`FLOAT`	Between 1.0 and 5.0.
`min_user_rating_count`	Specifies the minimum user rating count to consider. User rating count is the total number of reviews a place has. The minimum value is 0. If you specify a value below 0 the function returns an invalid argument error.	`INT64`	Minimum value is 0.
`max_user_rating_count`	Specifies the maximum user rating count to consider. User rating count is the total number of reviews a place has. The minimum value is 0. If you specify a value below 0 the function returns an invalid argument error.	`INT64`	Minimum value is 0.
`price_level`	Specifies the price levels to consider. You can specify multiple price levels.	`ARRAY<STRING>`	Supported values: `"PRICE_LEVEL_FREE"` `"PRICE_LEVEL_INEXPENSIVE"` `"PRICE_LEVEL_MODERATE"` `"PRICE_LEVEL_EXPENSIVE"` `"PRICE_LEVEL_VERY_EXPENSIVE"` Example: `["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]`
`business_status`	Specifies the business status to consider. You can specify multiple business status.	`ARRAY<STRING>`	Supported values: `"OPERATIONAL"` `"CLOSED_TEMPORARILY"` `"CLOSED_PERMANENTLY"` Example: `["OPERATIONAL","CLOSED_TEMPORARILY"]`
`takeout`	Considers places that offer takeout.	`BOOLEAN`	`TRUE`, `FALSE`
`delivery`	Considers places that offer delivery.	`BOOLEAN`	`TRUE`, `FALSE`
`dine_in`	Considers places that offer dine-in.	`BOOLEAN`	`TRUE`, `FALSE`
`curbside_pickup`	Considers places that offer curbside pickup.	`BOOLEAN`	`TRUE`, `FALSE`
`reservable`	Consider places that are reservable.	`BOOLEAN`	`TRUE`, `FALSE`
`outdoor_seating`	Considers places that offer outdoor seating.	`BOOLEAN`	`TRUE`, `FALSE`
`live_music`	Considers places that offer live music.	`BOOLEAN`	`TRUE`, `FALSE`
`allows_dogs`	Consider places that allow dogs.	`BOOLEAN`	`TRUE`, `FALSE`
`restroom`	Considers places that offer restrooms.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_breakfast`	Considers places that serve breakfast.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_lunch`	Considers places that serve lunch.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_dinner`	Considers places that serve dinner.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_beer`	Considers places that serve beer.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_wine`	Considers places that serve wine.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_brunch`	Considers places that serve brunch.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_vegetarian_food`	Considers places that serve vegetarian food.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_cocktails`	Considers places that serve cocktails.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_dessert`	Considers places that serve dessert.	`BOOLEAN`	`TRUE`, `FALSE`
`serves_coffee`	Considers places that serve coffee.	`BOOLEAN`	`TRUE`, `FALSE`
`menu_for_children`	Considers places that offer menus for children.	`BOOLEAN`	`TRUE`, `FALSE`
`good_for_children`	Consider places that are good for children.	`BOOLEAN`	`TRUE`, `FALSE`
`good_for_groups`	Consider places that are good for groups.	`BOOLEAN`	`TRUE`, `FALSE`
`good_for_watching_sports`	Consider places that are good for watching sports.	`BOOLEAN`	`TRUE`, `FALSE`
`accepts_credit_cards`	Consider places that accept credit cards.	`BOOLEAN`	`TRUE`, `FALSE`
`accepts_debit_cards`	Consider places that accept debit cards.	`BOOLEAN`	`TRUE`, `FALSE`
`accepts_cash_only`	Consider places that accept only cash.	`BOOLEAN`	`TRUE`, `FALSE`
`accepts_nfc`	Consider places that accept NFC payments.	`BOOLEAN`	`TRUE`, `FALSE`
`free_parking_lot`	Considers places that have free parking lot.	`BOOLEAN`	`TRUE`, `FALSE`
`paid_parking_lot`	Considers places that have paid parking lot.	`BOOLEAN`	`TRUE`, `FALSE`
`free_street_parking`	Considers places that have free street parking.	`BOOLEAN`	`TRUE`, `FALSE`
`paid_street_parking`	Considers places that have paid street parking.	`BOOLEAN`	`TRUE`, `FALSE`
`valet_parking`	Considers places that have valet parking.	`BOOLEAN`	`TRUE`, `FALSE`
`free_garage_parking`	Considers places that have free garage parking.	`BOOLEAN`	`TRUE`, `FALSE`
`paid_garage_parking`	Considers places that have paid garage parking.	`BOOLEAN`	`TRUE`, `FALSE`
`wheelchair_accessible_parking`	Considers places that have wheelchair accessible parking.	`BOOLEAN`	`TRUE`, `FALSE`
`wheelchair_accessible_entrance`	Considers places that have wheelchair accessible entrance.	`BOOLEAN`	`TRUE`, `FALSE`
`wheelchair_accessible_restroom`	Considers places that have wheelchair accessible restroom.	`BOOLEAN`	`TRUE`, `FALSE`
`wheelchair_accessible_seating`	Considers places that have wheelchair accessible seating.	`BOOLEAN`	`TRUE`, `FALSE`

Filter parameters Stay organized with collections Save and categorize content based on your preferences.

Filter parameters