{"id":20672117,"url":"https://github.com/workarea-commerce/workarea-google-address-autocomplete","last_synced_at":"2026-04-20T12:04:42.397Z","repository":{"id":56898475,"uuid":"203649577","full_name":"workarea-commerce/workarea-google-address-autocomplete","owner":"workarea-commerce","description":null,"archived":false,"fork":false,"pushed_at":"2020-01-27T14:02:42.000Z","size":127,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-03-15T05:45:59.787Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/workarea-commerce.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-21T19:17:12.000Z","updated_at":"2020-01-27T14:02:42.000Z","dependencies_parsed_at":"2022-08-21T02:20:25.520Z","dependency_job_id":null,"html_url":"https://github.com/workarea-commerce/workarea-google-address-autocomplete","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-google-address-autocomplete","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-google-address-autocomplete/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-google-address-autocomplete/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workarea-commerce%2Fworkarea-google-address-autocomplete/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workarea-commerce","download_url":"https://codeload.github.com/workarea-commerce/workarea-google-address-autocomplete/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242891328,"owners_count":20202326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T20:32:06.293Z","updated_at":"2026-04-20T12:04:42.367Z","avatar_url":"https://github.com/workarea-commerce.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Workarea Google Address Autocomplete\n================================================================================\n\nA Workarea Commerce plugin that adds a [Google Maps address autocomplete](https://developers.google.com/maps/documentation/javascript/examples/places-autocomplete-addressform) field to the addresses step of checkout in the Workarea Storefront. This\nfield searches Google Maps for an address and autocompletes the standard address\nfields with the selected address.\n\n![Google Address Autocomplete Example](example.png)\n\nGetting Started\n--------------------------------------------------------------------------------\n\nAdd the gem to your application's Gemfile:\n\n```ruby\n# ...\ngem 'workarea-google_address_autocomplete'\n# ...\n```\n\nUpdate your application's bundle.\n\n```bash\ncd path/to/application\nbundle\n```\n\nConfiguration\n--------------------------------------------------------------------------------\n\nTo integrate your Workarea application with Google Address Autocomplete you need configure your host application with your Google Address Autocomplete `apiKey`,\nwhich must be obtained [here](https://developers.google.com/maps/documentation/javascript/get-api-key)\n\nYou should use application secrets to do this. Add the following config to your `secrets.yml` file\n\n```yaml\n# ...\ngoogle_address_autocomplete:\n  :api_key: 'YOUR_API_KEY'\n# ...\n```\n\nThis plugin adds a `config.js` file to the Storefront's JavaScript manifest.\n\nThe object that this file provides contains two properties:\n\n- `apiKey`\nwhich must be added to `secrets.yml` (see above)\nwhich must be obtained [here](https://developers.google.com/maps/documentation/javascript/get-api-key)\nand,\n- `mappings` which contains an object that maps Google Places [component types](https://github.com/ubilabs/geocomplete#address-and-places-specific-component-types)\nand selector strings that match input elements within the autocomplete-enabled\nform. For example:\n\n```javascript\nmappings: {\n    'street_number': {  // Google Places Component Type\n        selector: '[name$=\"address[street]\"]',  // Selector for a form field\n        shortName: false  // Abbreviated?\n    },\n    'route': {\n        selector: '[name$=\"address[street]\"]',\n        shortName: false\n    },\n    'locality': {\n        selector: '[name$=\"address[city]\"]',\n        shortName: false\n    },\n\n    ... etc ...\n\n}\n```\n\nIf none of the input `[name]`s for the address partial have been changed in your\nproject, this plugin should work out of the box. If you have modified any of these\nattributes, or if you are wishing to collect more data from this plugin, you'll\nneed to modify or expand this configuration object for your project.\n\nWorkarea Commerce Documentation\n--------------------------------------------------------------------------------\n\nSee [https://developer.workarea.com](https://developer.workarea.com) for Workarea Commerce documentation.\n\nLicense\n--------------------------------------------------------------------------------\n\nWorkarea Google Address Autocomplete is released under the [Business Software License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-google-address-autocomplete","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkarea-commerce%2Fworkarea-google-address-autocomplete","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkarea-commerce%2Fworkarea-google-address-autocomplete/lists"}