Workarea Google Address Autocomplete

A Workarea Commerce plugin that adds a Google Maps address autocomplete field to the addresses step of checkout in the Workarea Storefront. This field searches Google Maps for an address and autocompletes the standard address fields with the selected address.

Google Address Autocomplete Example

Getting Started

Add the gem to your application's Gemfile:

# ...
gem 'workarea-google_address_autocomplete'
# ...

Update your application's bundle.

cd path/to/application
bundle

Configuration

To integrate your Workarea application with Google Address Autocomplete you need configure your host application with your Google Address Autocomplete apiKey, which must be obtained here

You should use application secrets to do this. Add the following config to your secrets.yml file

# ...
google_address_autocomplete:
  :api_key: 'YOUR_API_KEY'
# ...

This plugin adds a config.js file to the Storefront's JavaScript manifest.

The object that this file provides contains two properties:

  • apiKey which must be added to secrets.yml (see above) which must be obtained here and,
  • mappings which contains an object that maps Google Places component types and selector strings that match input elements within the autocomplete-enabled form. For example:
mappings: {
    'street_number': {  // Google Places Component Type
        selector: '[name$="address[street]"]',  // Selector for a form field
        shortName: false  // Abbreviated?
    },
    'route': {
        selector: '[name$="address[street]"]',
        shortName: false
    },
    'locality': {
        selector: '[name$="address[city]"]',
        shortName: false
    },

    ... etc ...

}

If none of the input [name]s for the address partial have been changed in your project, this plugin should work out of the box. If you have modified any of these attributes, or if you are wishing to collect more data from this plugin, you'll need to modify or expand this configuration object for your project.

Workarea Commerce Documentation

See https://developer.workarea.com for Workarea Commerce documentation.

License

Workarea Google Address Autocomplete is released under the Business Software License