Google Places icon

Google Places

Search for places using the Google Places API
Join our community

Actions3

Overview

The node integrates with the Google Places API to retrieve detailed information about places. Specifically, for the Place Details operation, it fetches comprehensive data about a single place identified by its unique Place ID. This is useful when you need rich details about a specific location, such as a restaurant, store, or landmark.

Common scenarios include:

  • Enriching customer databases with verified place information.
  • Displaying detailed place info in apps or websites.
  • Automating workflows that require place metadata like address, phone number, ratings, or opening hours.

Example: Given a Place ID of a popular cafe, the node can return its formatted address, contact number, user ratings, photos, and website URL.

Properties

Name Meaning
Place ID A textual identifier that uniquely identifies a place (required).
Additional Fields A collection of optional parameters:
- Language The language in which to return results. Options: English, French, German, Italian, Spanish.
- Region Region code to bias the search results (e.g., "fr" for France).
- Fields Specifies which fields to return in the response. Multiple selections allowed. Options include: Formatted Address, Formatted Phone Number, Geometry, Name, Opening Hours, Photos, Price Level, Rating, Reviews, Website. Defaults to Name, Rating, and Formatted Address.
- Max Results Maximum number of results to return (1-20). Not applicable for Place Details operation specifically.
- AI Agent Mode Whether to optimize output format for AI agents (simplified and structured).
- Include Summary When AI Agent Mode is enabled, whether to include a human-readable summary.

Output

The node outputs JSON objects representing place details with the following structure:

  • place_id: Unique identifier of the place.
  • name: Name of the place.
  • address: Formatted address.
  • rating: User rating score.
  • price_level: Price level indicator.
  • types: Array of place types/categories.
  • latitude and longitude: Geographic coordinates if available.
  • google_maps_link: Link extracted from photo attributions pointing to the place on Google Maps.

If no place details are found, the output contains an error message with the status.

When AI Agent Mode is enabled, the output is simplified and may include a human-readable summary listing all found places with key details.

Dependencies

  • Requires an API key credential for Google Places API.
  • Makes HTTP requests to https://maps.googleapis.com/maps/api/place/details/json.
  • No additional environment variables needed beyond the API key configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Place ID will result in no data returned or an error.
    • Exceeding Google Places API quota limits may cause request failures.
    • Incorrect API key or insufficient permissions will lead to authentication errors.

  • Error messages:

    • "No place details found": The provided Place ID did not return any data. Verify the Place ID is correct.
    • API errors related to quota or authentication should be resolved by checking API key validity and usage limits.

  • Resolution tips:

    • Ensure the Place ID is accurate and corresponds to an existing place.
    • Confirm the API key has access to the Google Places API and sufficient quota.
    • Use the "Additional Fields" to specify language or region to improve result relevance.

Links and References

Discussion