In this guide, we will give you insights into the Address Autocomplete integration, along with detailed instructions and important notes for integrating it into your app.
1. About Address autocomplete
Address autocomplete assists users in quickly and accurately entering their address information, which can minimize address entry errors and greatly enhance the user experience. The integration offers the current location and a list of address suggestions when users begin typing a few first characters.
Once Address autocomplete connected, it is supported in any native form asking for an address, such as Add Address and Edit Address. Please note that users can only see their current location when they grant location permission for the first-time use.

If the app uses the web checkout, then this feature is not in scope for the checkout. Logged-in users use the app's address book and not-logged-in users follow BigCommerce functionality.
2. Connecting Address autocomplete to your app
2.1. Access the Google Maps API key
You’ll need to have a Google Cloud project with
billing enabled in order to get a valid API key. To access the API key, follow the steps below:
- Log in to the Google API Console.
- Click Select a project and choose your existing project.
- Navigate to Credentials, and you will see the API Keys section. Click the key (consider restricting access as described in a note), and then copy it.

Below are some notes on optimizing costs for Google Maps and restricting API keys.
- Google Maps Platform has adopted a pay-as-you-go pricing model. After thoroughly analyzing the cost optimization best practices, we suggest the implementation of the Geocoding API and Place Autocomplete per request.
- You are advised to restrict the API key to ensure the security of your API credentials. In our implementation, edit your API key and make the following changes:
- Select IP addresses in the application restriction section. A list of our IP addresses will be shared with you.
- In the API restrictions section, select Restrict key, and then enable Geocoding API and Places API.
2.2. Provide the API key in Alphonso
- In Alphonso, navigate to Integrations, and then select Address autocomplete.
- Enter the API key in the Google Maps API key field. Finally, click Connect.
All's done!