Instructions
1. Add the Google Places element to your mobile page.

2. Enter your Google Places API key in the element settings.

3. Make sure the required Google Places APIs are enabled in your Google Cloud project.

4. Set the placeholder text if you want guidance inside the input, such as “Search for an address”.

5. Choose the place type you want to search for. Use “Address” for address pickers, delivery forms, checkout addresses, and location search.

6. Set the minimum characters before search starts. A value like 2 or 3 helps avoid sending searches too early.

7. Use the results state to display suggestions in your own Bubble UI.

8. When a user taps one of your displayed suggestions, use the Select result action with that result’s index.

9. Use the selected place states in your workflows after a place is selected.

10. If you want distance estimates, enter a distance origin as latitude and longitude, for example `6.5244,3.3792`.

11. If you want fixed suggestions, add them in the Predefined places JSON field.

12. Turn on “Always include predefined places” if those saved suggestions should appear together with Google results.

13. Use Bubble conditions to style or disable the input when needed.

14. Use the Clear action when you want to reset the search text, selected place, and results.

15. Keep Max results at 5 or lower, because Google Places returns up to 5 suggestions per request.

Predefined places JSON format

Use Predefined places JSON when you want to show your own saved places, popular locations, branches, service areas, or frequently used addresses.

Each item should include:

- `description`: The full place or address text.
- `place_id`: A unique ID for your saved place. This can be your own custom ID.
- `geometry.location.lat`: The latitude.
- `geometry.location.lng`: The longitude.

Example:

[
 {
   "description": "Ikeja City Mall, Obafemi Awolowo Way, Ikeja, Lagos, Nigeria",
   "place_id": "predefined_ikeja_city_mall",
   "geometry": {
     "location": {
       "lat": 6.6018,
       "lng": 3.3515
     }
   }
 },
 {
   "description": "Lekki Phase 1, Lagos, Nigeria",
   "place_id": "predefined_lekki_phase_1",
   "geometry": {
     "location": {
       "lat": 6.4474,
       "lng": 3.4723
     }
   }
 }
]

Notes

- The plugin publishes result data so you can design your own suggestion list.
- Google billing, API access, and key restrictions are controlled from your Google Cloud account.
- Distance values may only appear when Google returns distance data for the search.
- Predefined places do not need to come from Google. They can be your own saved locations.
- For best results, use a restricted API key that is allowed for your app setup.