Docs

How to Switch FunnelKit to Google Places API (New)

Updated on

FunnelKit now supports Google’s Places API (New), the API that powers address autocomplete on your checkout.

Google has deprecated the original Places API. Address autocomplete on your checkout still works with it, but new Google Cloud projects can no longer enable the legacy API. So every store will eventually need a key that supports Places API (New).

This guide shows how to check your current key, create a new one, and switch your store over.

Note: This guide has been revised to use Google’s modern Places API (New). Google has deprecated Place Autocomplete (Legacy) API, and new Google Cloud projects can no longer enable it.

  • Setting up address autocomplete for the first time? Follow this guide.
  • Already using a legacy key? Your checkout autocomplete will keep working for now. You can still view the earlier setup process for reference. However, since Place Autocomplete (Legacy) API is deprecated, we highly recommend switching to a Places API (New) key using this guide.

How FunnelKit Tells You Your Key Needs Updating

If your saved key only works with the legacy API, FunnelKit shows a notice right inside the Funnel Builder screens.

The notice explains what changed, takes you straight to your settings, and links to the documentation. Once you’ve dealt with it, you can dismiss it and it won’t come back.

FunnelKit admin notice saying the Google Places API key needs updating

Where Your API Key Lives

Your API key sits under FunnelKit > Settings > General, in the Google Maps section. FunnelKit checks the key with Google in the background and shows one of three results under the field.

  1. Warning under the field: The key only supports the legacy Places API. Checkout keeps working on the legacy API until you replace the key.
notice if api is not working
  1. Red error under the field: Google rejected the key, for example due to a typo, the wrong project, or restrictions that block this site. The error shows the reason Google gave. Address autocomplete won’t work until the key is fixed.
FunnelKit settings with a red alert about the Google Maps API key
  1. No badge: There’s no badge or green tick for a working key. If there’s no message under the field, your key is good.
FunnelKit settings showing the Google API key field with no update notice

How to Create a Places API (New) Key

You’ll create the key in Google Cloud Console. It takes a few minutes. If you want more detail on any step, see Google’s official guide to set up the Places API (New).

  1. Open console.cloud.google.com and pick the project your store uses.
  2. Make sure billing is enabled on that project.
  3. Open the API Library and enable Places API (New). It’s listed as places.googleapis.com.
  4. Go to Google Maps Platform > Keys & Credentials and choose Create Credentials > API Key.
  5. In the Create API Key panel, open Select API restrictions. Clear everything this key doesn’t need and leave Places API (New) selected.
  6. While you’re there, add a website restriction for your store’s domain.
  7. Copy the key.

How to Add the New Key in FunnelKit

Go to FunnelKit > Settings > General and find the Google Maps section.

Paste your new key into the Google Maps API key field.

FunnelKit settings field for adding the Google Places API key

Click Save.

Once saved, the warning disappears, and the Funnel Builder notice stops appearing. Address autocomplete on your checkout will run on the Places API (New).