---
description: >-
  Request participants can auto-complete street, location, and/or business
  addresses entered into a Screen control.
---

# Google Places Package

## Overview

Use the Google Places package to allow Request participants to do the following in Form-type Screens:

* Start entering an address, location, or business name into a Screen control, then allow the Google API to auto-complete that address or location. The Google Place control stores the selected address in the Request data as well as all the returned data from the Google API.
* View and/or select from one or more geographical locations in a Google map.

Prior to using the Google Places package, ensure that your organization has a [billing account](https://developers.google.com/maps/gmp-get-started) with the [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/overview) and [Places API](https://developers.google.com/places/web-service/overview) enabled, as well as API keys for each API.

The Google Places package has the following components after it is installed:

* **Screen Builder control:** The Google Places package installs the Google Places control into Form-type Screens. After adding and configuring a Google Places control into your Screen, Request participants start entering an address, then receive auto-complete address options from which to select as the intended address, location, or business name. The Google Place control stores the selected address in the Request data using that control's **Variable Name** setting value, as well as all the returned data from the Google API. See [Google Places Control Settings](broken-reference).
* **Environment Variable:** The Google Places package adds an [Environment Variable](broken-reference) called `GOOGLE_API_TOKEN` that contains the Google API token for that ProcessMaker instance. The Environment Variable does not require configuration or revision after it has been added to your ProcessMaker instance.

The Google Places control uses the Google API token to call the Google API when a Google Places control is placed into a Screen, then when address information is entered into the control. Google uses Basic Service Set Identifiers (BSSID) information from the Request participant's Wireless Local Area Network (WLAN) Access Point to get an approximation of where that Request participant is located, even when GPS and WiFi are not available.

Below are a few ways to use the Google Places package:

* Allow Request participants to easily enter a shipping or billing address.\
  <img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FZgJeNwiinALvehcNW9fy%2Fgoogle%20package%201.avif?alt=media&#x26;token=bfe24d28-4b06-4e57-bab2-82a7672873e5" alt="" data-size="original">&#x20;
* Enter a business name into the Google Places control to select a business location.\
  <img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FUrkDHx3Rc7NtEsQsV4B6%2Fgoogle%20package%202.avif?alt=media&#x26;token=7f4153cd-607d-4215-a0a8-70fe50d6a6c9" alt="" data-size="original">&#x20;
* Enter well-known monuments or international airport names to get their addresses or locations when requesting to travel.\
  <img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2F9WRfZac7XdoK3kXAEtPE%2Fgoogle%20package%203.avif?alt=media&#x26;token=d25b939e-5ec0-4491-b7d3-f557f84500c0" alt="" data-size="original">&#x20;
