text_query | string | Yes | - | The text string to search for. Examples: ‘Best place to visit in San Francisco’, ‘pizza hut in New York’. The API returns candidate matches ordered by perceived relevance. For best results, include a location context (city/area) in the query. Avoid ambiguous queries, too many concepts/constraints in one query, PO Boxes, postal address elements not on Google Maps, latitude/longitude coordinates, historical names no longer in use, unofficial/vanity names, and non-geospatial intent (e.g., questions). |
country | string or SelectableOption | No | - | Optional ISO-2 region code to bias results (e.g., AE, US, GB). If omitted, the Places API may bias results based on the caller’s IP address. |
language | string or SelectableOption | No | - | Optional language code for results (e.g., EN, AR). Will be normalized to a Places API languageCode. |
included_type | string or SelectableOption | No | - | Optional Places type filter (e.g., restaurant, cafe). |
price_levels | array of string or SelectableOption | No | - | Optional price level filters. Available options: PRICE_LEVEL_UNSPECIFIED, PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE |
limit | integer | No | 20 | Maximum number of places to return. Uses pagination. Note: Places Text Search (New) returns a maximum of ~60 results across all pages (subject to change). |
