GPlaces icon

GPlaces

Interact with Google Places API (New) - Text Search and Nearby Search

Actions2

Text Search

AI-generated

Summary

Perform a text-based search for places using a query string, optionally applying filters such as place type, location bias or restriction, minimum rating, open status, price level, and more, returning place data fields per selection.

Inputs

  • Text Query (required) — The text string to search for places, such as 'pizza in New York' or 'coffee shop near Central Park'.
  • Included Type — Filter results to places matching a specific type (e.g., restaurant, bar, pharmacy, hotel).
  • Location Bias — Bias results toward a geographic area using JSON format for either a circular area (center latitude, longitude, radius in meters) or a rectangular viewport (low/high coordinates).
  • Location Restriction — Restrict results to a specific rectangular area, recommended for categorical queries, using JSON with low/high latitude and longitude coordinates.
  • Language Code — Set the language for returned place data using BCP 47 codes (default is 'en').
  • Min Rating — Minimum average user rating threshold (0.0 to 5.0) to filter out lower-rated places.
  • Open Now — If enabled, returns only places currently open for business.
  • Price Levels — Filter results by selected price levels (Inexpensive, Moderate, Pricey, Ultra High-End).
  • Rank Preference — Choose how to rank results: by relevance to query (default) or by distance from location (requires location bias/restriction).
  • Page Size — Number of results per page (1 to 20).
  • Return All — When enabled, automatically fetches all pages of results using pagination tokens.
  • Strict Type Filtering — If enabled, returns only places whose primary type exactly matches the included type.
  • Include Pure Service Area Businesses — Include businesses serving customers at their locations without a physical storefront.
  • Fields — Specify which fields of place data to return (e.g., displayName, location, formattedAddress). Default includes name, ID, address, and location.

Output shape

a list of place records matching the text query and applied filters

Results are paginated with a maximum of 20 entries per page; enabling Return All fetches all pages automatically. Each item contains place data json with fields as specified. If no places match, a single message record is returned explaining no results were found.

Links

Discussion