Google Places
Configure Google Places integration to enable address autocomplete at checkout.
The Google Places integration adds address autocomplete to your storefront's checkout page. When a customer begins typing in the Address Line 1 field, a dropdown of matching addresses appears powered by the Google Places API. Selecting an address auto-fills the city, state, zip code, and country fields, reducing data entry errors and speeding up checkout.
This integration requires a Google Cloud Platform API key with the Places API and Maps JavaScript API enabled.
Configure Google Places
- From your Unified Admin, go to Settings > Partner Apps > Google > Google Places.
- Enter your Google Places API key in the API Key field.
- Click Save.
Settings
| Field | Description |
|---|---|
| API Key | Your Google Cloud Platform API key. This key must have the Places API and Maps JavaScript API enabled in the Google Cloud Console. The key is stored securely per-storefront and injected into the checkout page at runtime. Leave blank and save to disable the integration. |
How It Works
When a valid API key is configured, the storefront checkout page loads the Google Maps JavaScript API with the Places library. The autocomplete widget attaches to the shipping address Address Line 1 field and listens for user input.
When a customer selects an address from the autocomplete dropdown:
- Address Line 1 is populated with the street number and route
- City is populated from the locality component
- State / Province is populated from the administrative area
- Zip / Postal Code is populated from the postal code component
- Country is populated from the country component
The autocomplete is restricted to geocode-type results (street addresses) to provide the most relevant suggestions.
Associations
Print Store
| Area | Effect |
|---|---|
| Checkout - Shipping Address | When enabled, the Address Line 1 field on the checkout page gains autocomplete powered by Google Places. Customers see address suggestions as they type and can select one to auto-fill all address fields. |
| Address Validation | Google Places autocomplete works alongside the separate Google Address Validation integration. Places handles autocomplete suggestions during input, while Address Validation verifies the final address before order submission. |
Related Pages
- Google Address Validation — verifies the final address after Places autocomplete fills the fields
- Google Map — display shipment location on order tracking pages
- Checkout Fields — customize the checkout form fields that Places autocomplete populates