Close Menu

googleplacesautocomplete

Welcome to the documentation for the Google Places Autocomplete library! In this guide, we will walk you through the process of integrating Google Places Autocomplete into your application.

Installation

To get started, follow these steps to install the Google Places Autocomplete library:

  1. Navigate to the root directory of your project.
  2. Open the terminal and run the following command to install the library via CocoaPods:


    pod 'GooglePlacesAutocomplete'

Setup

To use Google Places Autocomplete, you need to set up your API key:

  1. Visit the Google Cloud Platform Console.
  2. Create a new project or select an existing project.
  3. Click on the “Enable APIs and Services” button.
  4. Search for “Places API” and click on it.
  5. Click the “Enable” button to activate the API.
  6. In the left sidebar, click on “Credentials.”
  7. Click on the “Create Credentials” button and select “API Key.”
  8. Copy the generated API Key.

Integration

Follow these steps to integrate the Google Places Autocomplete library into your project:

  1. In the project explorer, open the file where you want to implement autocomplete functionality.
  2. Import the library by adding the following import statement:


    import GooglePlaces

  1. Create a GMSAutocompleteViewController object to display the autocomplete UI:


    let autocompleteController = GMSAutocompleteViewController()

  1. Set the delegate for the autocomplete view controller:


    autocompleteController.delegate = self

  1. Present the autocomplete view controller:


    present(autocompleteController, animated: true, completion: nil)

Handling Autocomplete Results

To handle autocomplete results, conform to the GMSAutocompleteViewControllerDelegate protocol:


    extension YourViewController: GMSAutocompleteViewControllerDelegate {
      
      func viewController(_ viewController: GMSAutocompleteViewController, didAutocompleteWith place: GMSPlace) {
          // Handle the selected place
      }
      
      func viewController(_ viewController: GMSAutocompleteViewController, didFailAutocompleteWithError error: Error) {
          // Handle the autocomplete error
      }
      
      func wasCancelled(_ viewController: GMSAutocompleteViewController) {
          // Handle when the user cancels autocomplete
      }
      
    }

Additional Configuration

Google Places Autocomplete provides additional configuration options, such as setting the filter type, restricting results to specific countries, and more. Check the official documentation for more details on customizing your autocomplete setup.

With the Google Places Autocomplete library, you can easily integrate autocomplete functionality into your app, making it more user-friendly and efficient. Explore the various configuration options and enhance the user experience of your application.