ProcessMaker Developers Documentation
processmaker.comKnowledge CenterProcessMaker University
Guides
Guides
  • Getting Started
    • Installing ProcessMaker
  • Authentication
    • Creating a Client Application
    • Getting an Access Token
    • Getting a Refresh Token
  • Working with the API
    • Starting a Request via REST API
    • Starting a Request via Web Hook
  • Embedding Forms
    • Starting a Request via Anonymous Web Entry
    • Participating in a Workflow via Intermediate Web Entry (Anonymous)
    • Participating in a workflow via Intermediate Web Entry (Authenticated)
    • Angular Inbox Tutorial
      • Part 0: Overview
      • Part 1: Hello World
      • Part 2: Services & Dependencies
      • Part 3: Components
      • Part 4: The Inbox
      • Part 5: The Screen & Form Elements
  • Script Task Examples
    • PHP
  • Packages
    • ProcessMaker Platform Packages
      • Actions By Email Package
      • Advanced Screens Package
      • Advanced User Package
      • Auth Package
      • C# Package
      • Collections Package
      • Comments Package
      • Conversational Forms Package
      • Data Connector Package
      • Decision Tables Package
      • Documentation Package
      • DocuSign Package
      • Dynamic UI Package
      • File Manager Package
      • Google Places Package
      • IDP Package
      • Java Package
      • PDF Generator Package
      • PM Blocks Package
      • Process Optimization Package
      • Python Package
      • R Package
      • Saved Searches Package
      • Send Email Package
      • Signature Package
      • Slack Notification Package
      • Translations Package
      • Versioning Package
      • Vocabularies Package
      • Web Entry Package
    • Custom Packages
      • The Package Skeleton
      • Creating Your First ProcessMaker Package
Powered by GitBook
On this page
  1. Packages
  2. ProcessMaker Platform Packages

Google Places Package

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

PreviousFile Manager PackageNextIDP Package

Last updated 1 year ago

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 with the and 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 .

  • Environment Variable: The Google Places package adds an 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.

  • Enter a business name into the Google Places control to select a business location.

  • Enter well-known monuments or international airport names to get their addresses or locations when requesting to travel.

billing account
Maps JavaScript API
Places API
Google Places Control Settings
Environment Variable