portal-google-autocomplete/README.md

For DGtek portal only. This package uses Google autocomplete and geolocation to check the address to be in the footprint (DGtek buildings and polygons).

# portal-google-autocomplete

### Package installation

```
yarn add portal-google-autocomplete
```

### Start package

```js
import PortalGoogleAutocomplete from 'portal-google-autocomplete'

customElements.define('portal-google-autocomplete', PortalGoogleAutocomplete)
```

### Set API host

```html
<portal-google-autocomplete host="https://example.com/api" />
```

The package does not load Google maps API.

The Google maps script is expected to be loaded by your application.

You should wait for Google maps script has been loaded before you start to use the package:

##### data

```js
mapIsReady: false
```

##### mounted hook

```js
function waitForGoogleMapsScript () {
  if (!window.google) window.requestAnimationFrame(waitForGoogleMapsScript.bind(this))
  else this.mapIsReady = true
}

window.requestAnimationFrame(waitForGoogleMapsScript.bind(this))
```

##### Catch events

Submit button event:

```js
window.addEventListener('new-address-data', function (event) {
  console.log(event.detail) /* replace this with your code */
})
```
During checking the address, a number of requests will be made to remote server.

Every request can fail.

```js
window.addEventListener('server-error', function (event) {
  console.log(event.detail) /* { error: true, errorType: String, errorMessage: String } */
})
```

##### mounted hook

```js
window.addEventListener('new-address-data', this.catchEvent)
```

##### beforeDestroy hook

```js
window.removeEventListener('new-address-data', this.catchEvent)
```