Location (Google Maps) - Jodoo

Introduction

Location (Google Maps) plugin offers geolocation, reverse geolocation, facilitating location retrieval and data input for forms.

It allows you to obtain location-related information via Single Line or Multi Line fields, such as latitude, longitude, postal code, detailed address, and so on. You can also adjust the retrieved location as permitted. For example, if an employee is making attendance remotely, this plugin can be applied to obtain his/her location for remote clock-ins, ensuring efficient and accurate record-keeping for employers.

Application Scenario(s)

The Location (Google Maps) plugin offers versatile location tracking for different situations that adapt to your needs, making location tracking a breeze.

In the case of remote work monitoring, employers can effortlessly oversee remote employees. Keep tabs on remote employees' work locations to ensure they're working from approved places. Boost productivity and accountability with ease.
Similarly, when managing attendance for events and classes, educational institutions and event organizers can seamlessly track attendance at seminars, workshops, and conferences. Attendees can conveniently check in remotely, simplifying event logistics.
This plugin also fits perfectly for optimizing inventory management. Businesses can monitor the movement and location of items within warehouses or between different locations, ensuring precision and efficiency.

Preview

In the case of remote work, you can use this plugin to keep an eye on remote employees and verify if they are working from approved locations. When an employee clicks the Clock In button, the current location is automatically retrieved. A map will pop out, allowing the employee to adjust their location within an approved radius based on your settings. After that, the employee can simply close the window, and the modified location will be automatically recorded in the form.

Plan Description

The Location (Google Maps) plugin is a paid plugin. Each location query, including the debug tests, will cost you around $0.054 (dollar).

Note:
The Google Maps Platform provides the location service. Click here for detailed guidance from Google support to view and download the cost details of your invoice or statement.

Plugin Parameter(s)

Request Parameters

Google Maps API Key

The Google Maps Platform provides the location service. You need to enter the Google Maps API key before using the plugin to connect with the Google Maps Platform.

Follow the steps to create and verify the key:

1. Click here and log into your Google account.

2. On the APIs & Services page, click to enable the Maps JavaScript API, Places API, and Geocoding API.

Once the API is successfully enabled, the option will change from to . If the option is set to , it means the API has been successfully enabled.

3. On the Keys & Credentials page, click to open/create a project.

4. Click CREATE CREDENTIALS to generate an API key, and make sure to copy it.

5. Verify the copied key on Jodoo.

Notes:
1. The new API keys are listed under API keys.
2. For more guidance on managing Google APIs, see Use API Keys.

Adjust Location Within Radius (in meters)

You can adjust the location to minimize errors when filling out a form. By default, it is set to 0, meaning members can not adjust their location. If you leave the field blank, there will be no restrictions on adjusting the location. If you enter any unexpected value, for example, a number less than zero, it will default to 0.

There are two options for setting Adjust Location Within Radius (in meters):

If you select Custom, manually enter a number.
If you select Field Value, select a Number field.

Response Parameters

You can save the retrieved location information into the Single Line and Multi Line fields.

The plugin can return the following location information:

Parameter	Description
Latitude	Returns the latitude of the tracked location. Defined using numerals that have a precision of six decimal places. Latitudes can take any value between -90 and 90. Precision beyond the six decimal places is ignored.
Longitude	Returns the longitude of the tracked location. Defined using numerals that have a precision of six decimal places. Longitude can take any value between -180 and 180. Precision beyond the six decimal places is ignored.
Current Location	Returns a string containing the human-readable address of this location. The formatted address is logically composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" consists of the following components: "111" (the street number), "8th Avenue" (the route), "New York" (the city) and "NY" (the US state).
Country/Region	Returns the national political entity and is typically the highest order type returned by the Geocoder.
Postal Code	Returns a postal code as used to address postal mail within the country.
State/Province	Returns a first-order civil entity below the country level.
City	Returns an incorporated city or town political entity.
Block	Returns a first-order civil entity below a locality.
Street	Returns a precise street address.
Street Number	Returns the precise street number.

Plugin Installation & Configuration

Installing the Plugin

Follow the steps to install the plugin:

Click here to visit Market.
Search for the Location (Google Maps) plugin.
Open the Location (Google Maps) plugin, and click the Install button in the popped-out window to install it.

Note:
For details, see the section "Installing Plugin(s)" in Plugin Market.

Enabling/Disabling the Plugin

On the Plugin page, click to enable/disable the plugin.

Creating a Form

Take remote attendance as an example. Create an Employee Clock In form with the following fields:

Field Name	Field Type	Field Properties
Employee Clock In	Divider	/
Name	Member	Set Initial Value as Current User. Untick Edit for Field Permissions.
Department	Department	Set Initial Value as Department of Current User. Untick Edit for Field Permissions.
Clocked in at	Date&Time	Set Type as YYYY-MM-DD HH:MM. Set Initial Value as Current Time. Untick Edit for Field Permissions.
Location	Single Line	Untick Edit for Field Permissions.
Clock in	Button	For details, see the next section, "Configuring the Clock in Field."

Configuring the Clock in Field

1. Drag and drop to add a Button field.

2. Go to Field Properties > Button Text, and change the button text to Clock in.

3. Open Settings for Triggered Action, and click Add Action.

4. Set Event Name of Front-End Event as Clock in location.

5. Make the below settings for Triggered Action:

Select the plugin: select the Location (Google Maps) plugin.
Enter the Google Maps API Key.
Set Adjust Location Within Radius (in meters) as Custom, and enter a custom number, such as 50.
Click Add, and set the rule as saving Current Location to the Location field. Click Save after the settings.

Note(s)

For a computer or PWA on mobile, the plugin shows location information in the browser's language.
In the Jodoo app on mobile, the plugin displays the location information in the device's language.
The location permission needs to be enabled for the browser, app, and device before you can use the plugin. This ensures that the plugin can access your device's location.
When you are using the plugin on a computer, the success rate and accuracy of location tracking may be influenced by your device and web browser. Here are some scenarios in which locating may not work:

Your device doesn't support GPS.
Location permission is not enabled for our plugin (Jodoo).
The success rate for location service on web browsers is relatively low. The success rate and accuracy can vary depending on the web browser you're using.

Browser	Success Rate	Accuracy
Safari	High	High
Edge	Moderate	Low
Chrome	Low	High

To minimize location errors, configure the Adjust Location Within Radius (in meters). This feature allows members to manually correct their location if needed.