Description

The Google Places Interface Asset is a powerful integration with the Google Places API that enables real-time identification of local places, businesses, and points of interest for display within Intuiface experiences.

With this Interface Asset, you can dynamically retrieve and display live data, such as place names, ratings, categories, photos, addresses, and opening hours, all based on real-time Google Maps data.

This Interface Asset is compatible with all Player-supported platforms, including web deployments, but is not supported in Player Classic.

Disclaimer: This Interface Asset uses an API key with a limited quota. It is recommended that you use your own API key for production experiences.

Here is an example.

Properties, triggers, and actions

This Interface Asset contains two triggers, four actions, and seven properties. Each action includes its own set of parameters.

Properties

• API Key: Optional API key used for authenticating Google Places requests.

• Language Code: Language used for all Google Places API responses (default: en).

• Max Results: Maximum number of results returned from search requests.

• Number of Results (Read-Only): Number of results returned by the last search.

• Summary Results: A list of properties containing lightweight search results.

  • Name: The name of the place.

  • Place ID: The unique Google Places identifier for this place.

  • Icon URL: URL of the place’s icon image.

  • Icon Background Color: Background color associated with the place icon.

  • Rating: The average user rating (0–5).

  • Open Now: Indicates whether the place is currently open.

  • Latitude: The latitude coordinate of the place.

  • Longitude: The longitude coordinate of the place.

• Selected Place (Read-Only): A list of properties containing full details for the selected place.

  • Name: The name of the place.

  • Latitude: The latitude coordinate of the place.

  • Longitude: The longitude coordinate of the place.

  • National Phone Number: Phone number in national format.

  • International Phone Number: Phone number in international format.

  • Formatted Address: Full formatted address of the place.

  • Place ID: The unique Google Places identifier for this place.

  • Rating: The average user rating (0–5).

  • Total Ratings: Total number of user ratings submitted for the place.

  • Price Level: Price indicator (0–4) assigned by Google.

  • Business Status: Indicates the current status (e.g., OPERATIONAL, CLOSED_TEMPORARILY, etc.).

  • Types: Comma-separated list of category types for the place.

  • Icon URL: URL of the place’s icon (Google iconMaskBaseUri).

  • Icon Background Color: Hex color value used behind the icon.

  • Photos: Array of URLs for place photos.

  • Website: Official website of the place, if available.

  • Open Now: Indicates whether the place is currently open.

  • Opening Hours: Array of weekday schedule descriptions.

  • Google Maps URL: A direct link to the location on Google Maps.

• Calculated Radius (Read-Only): If a Radius is not supplied in an action (see below), the search radius is automatically calculated from zoom + map width.

Triggers

• Search Success: When a search completes successfully.

  • Message: Success message

• Search Failed: When a search request encounters an error.

  • Error: Error message describing the failure.

Actions

• Clear Results: Clears all search results and resets related properties.

• Search Text: Performs a text-based Google Places search.

  • Text Query: The search query text (e.g., “pizza near London”).

  • Included Type: Optional Google Places type filter.

  • Zoom: Optional map zoom level for auto-radius calculation.

  • Map Width: Optional map width in pixels (used for auto-radius).

  • Latitude: Optional latitude of map center.

  • Longitude: Optional longitude of map center.

  • Radius: Optional search radius in meters.

• Get Place Details By ID: Retrieves full place details using a Place ID.

  • Place ID: The ID of the place to retrieve.

• Search Nearby Places: Searches for nearby places using coordinates, radius, and types.

  • Latitude: Center latitude for the search.

  • Longitude: Center longitude for the search.

  • Radius: Search radius in meters.

  • Included Type: Primary place type(s), comma-separated.

  • Place ID: Optional place ID for direct lookup.

  • Zoom: Optional map zoom level for auto-radius calculation.

  • Map Width: Optional map width in pixels (used for auto-radius).