Mapping Grid Records with Google Maps

Overview

Google Maps integration allows users to visualize site, dispatch, or employee records directly from supported grids. When enabled, users can map records using flexible row-selection options, making it easy to view locations for operational planning and analysis.

Supported Grids and Columns

Mapping functionality is available on grids that contain at least one of the following columns:

• SiteNo
• DispatchNo
• EmployeeNo

⚠️ Unlike version 24, the map button no longer appears on all grids that contain these columns.  Note: Currently, the only grid with a visible map button is the Dispatch Queue (Dispatch Q).

How to Map Records from a Grid

1. Navigate to a supported grid (for example, Dispatch Q).
2. Right-click anywhere within the grid to open the context menu.
3. Select Map Rows.
4. Choose one of the following mapping options:
   • All Rows – Maps every row in the grid.
   • Selected Rows – Maps only rows you have explicitly selected.
   • Highlighted Rows – Maps rows that are visually highlighted.
   • Filtered Rows – Maps only rows currently included by active filters.
5. The selected records will be plotted on Google Maps.

Configuration Requirements

The Map Rows option will only be available and functional when all required conditions are met:

1. Valid Grid Structure
   The grid must include a siteno, dispatchno, or employeeno column
2. Google Maps API Configuration (Required)
   • Must be configured to plot coordinates on the map
   • See additional instruction below
3. Google Geocode API Configuration (Optional)
   • When configured, the system can retrieve coordinates for site or employee records that do not already have latitude and longitude saved
   • See additional instruction below
4. Integration Setting Enabled
   • The INTEGRATION_GOOGLE configuration must be set to ON

Enable this integration:

1. User must sign up for their own Google Developers Console account and generate an API key.  IMPORTANT: User must ensure the key is enabled in Google Developer Console for both the Maps Javascript API and the Geocoding API, in order for this integration to function properly.
2. Within Q360 Maintenance > API Configuration > Google Maps form: paste the key into the “Google Maps Javascript API Key” field and click the ‘Save’ button.  Best practice is to use the same key for the next step, though two different keys can be used.
3. Within Q360 Maintenance > API Configuration > Google Geocode form: paste the key into the “Google Maps Javascript API Key” field and click the ‘Save’ button

Version Behavior Notes

v25 and later:

• The map button appears only on specific, supported grids.

v24 and earlier:

• The map button appeared on any grid that contained a supported column.