Google Places (New) icon

Google Places (New)

Search for places, nearby locations, or fetch place details using the Google Places API (New)

Actions3

Text Search

AI-generated

Summary

Search for places by providing a free-text query, optionally filtering and customizing the output fields.

Inputs

  • Text Query (required) — A free-text string specifying what to search for; combining city and place type is recommended for best results.
  • Field Mask — Comma-separated list of field paths to specify which place data fields to return, optimizing response speed and cost.
  • Max Results — The maximum number of place results to return, between 1 and 20.
  • Additional Options — Optional settings including language code (BCP-47), region code (CLDR two-letter), and minimum rating threshold (0–5) to filter and customize search results.

Output shape

a list of place objects matching the search criteria

Each item returned corresponds to a place matching the text query, containing only the fields specified by the Field Mask. The number of items returned respects the Max Results limit. Results can be filtered by minimum rating, language, and region. Errors may be included per item if settings allow continuation on failure.

Examples

Example 1: Search for urgent care clinics in Austin, TX with default fields and up to 20 results.

Set Text Query to 'urgent care clinics in Austin TX'. Leave Field Mask at default, Max Results at 20, and Additional Options unset or default.

Example 2: Get top 5 restaurants in New York with minimum 4-star rating in Spanish.

Set Text Query to 'restaurants in New York'. Set Max Results to 5, Additional Options Language Code to 'es', and Min Rating to 4.

Links

Discussion