Creating a Google Map Widget

Creating a Google Map Widget

Plotting Google Map Widget (Release 4.2 Onwards)

Overview

The Google Map widget in RubiSight allows you to visualize geographical data using latitude and longitude coordinates. Data points can be displayed as map markers or circles on the map based on the configured coordinates and value measures.

The widget supports additional map customization options such as KML layers, overlay images, marker formatting, and circle visualization.

Prerequisites

To plot data on the Google Map widget, the following columns are required:

Field

Description

Latitude

Latitude coordinate values

Longitude

Longitude coordinate values

Value

Measure used for plotting and analysis

Important Notes

  • Latitude and Longitude columns must contain numeric values only.
  • Do not use symbols such as °, commas, or text in coordinate values.
  • Example valid values:
    • Latitude: 18.5204
    • Longitude: 73.8567
  • Invalid examples:
    • 18.5204°
    • 73.8567 E

​
Configuring the Google Map Widget

  1. Add the Google Map widget to the dashboard.
  2. Drag and drop:
    • Latitude column into the Latitude field.
    • Longitude column into the Longitude field.
    • Required measure into the Value field.
  3. The map plots the data points automatically based on the coordinates.


The plotted Google Map appears as below:

​
Supported Formatters

The Google Map widget provides the following formatter options:

Below are the some chart specific formatters:

  • KML Layer
  • Overlay Images
  • Marker
  • Circle
  • Map Info Window

 

KML Layer

Overview

The KML Layer option allows you to overlay geographical boundary or region data on the map using KML files.

KML (Keyhole Markup Language) files are commonly used to display:

  • Geographic boundaries
  • Regions
  • Routes
  • Zones
  • Custom map shapes

This helps in adding additional geographical context to the map visualization.

​
Available Options

URL Option

Use this option to load a KML file from an externally hosted URL.

Use Cases

  • Display country or state boundaries
  • Show predefined routes or regions
  • Load centrally managed KML files

Steps

  1. Enable the KML Layer formatter.
  2. Select the URL option.
  3. Enter the publicly accessible KML file URL.
  4. The KML layer is rendered on the map.

Upload File Option

Use this option to directly upload a KML file into the widget.

Use Cases

  • Internal region mapping
  • Custom territory visualization
  • Offline or local KML usage

Steps

  1. Enable the KML Layer formatter.
  2. Select the Upload File option.
  3. Upload the required .kml file.
  4. The uploaded geographical layer is displayed on the map.

Notes

  • Only valid KML files are supported.
  • Ensure the KML structure is properly formatted.
  • Large KML files may affect rendering performance.

 

Overlay Image

Overview

The Overlay Image formatter allows users to place a custom image over a specific geographical area on the map.

Below are the available formatter options under ‘Overlay Image’ formatter.

This is useful for displaying:

  • Heatmaps
  • Floor plans
  • Weather overlays
  • Satellite comparison images
  • Custom geographical visuals

Overlay Image Options

Option

Description

Image URL

URL of the image to overlay on the map

SW Latitude

South-West latitude coordinate

SW Longitude

South-West longitude coordinate

NE Latitude

North-East latitude coordinate

NE Longitude

North-East longitude coordinate

Opacity

Controls image transparency from 0 to 1

Coordinate Usage

The overlay image is positioned using two coordinate points:

  • South-West (SW) coordinates
  • North-East (NE) coordinates

These coordinates define the image boundaries on the map.

 

Opacity

The opacity setting controls the transparency level of the overlay image.

Allowed values are between 0 to 1

Example Use Cases

  • Overlaying building layouts
  • Comparing map changes
  • Adding weather radar visuals
  • Highlighting custom geographical zones

 

Marker Formatter

Overview

The Marker formatter controls color for pin.

These markers control how location points are displayed on the map.

Markers represent plotted geographical coordinates.

As can be seen from the below screenshot, the marker formatter option of color is controlling the color of Pin on the chart.

​
Marker Features

  • Displays location pins on the map
  • Supports visualization of multiple geographical points
  • Helps identify exact locations

Use Cases

  • Population mapping
  • Store locations
  • Asset tracking
  • Customer distribution analysis

Notes

  • Marker positions are based on Latitude and Longitude values.
  • Incorrect coordinates may plot markers in invalid locations.

 

Circle Formatter

Overview

The Circle formatter displays circles around plotted coordinate locations.

This helps visualize coverage, density, or geographical influence areas.

Circle Options


Option

Description

Color

Sets the circle border or fill color

Radius

Controls the size of the circle

Radius

The radius determines the area covered around each plotted coordinate.

Larger radius values create wider coverage areas.

This radius option is relative and set in proportion based on value. Larger value gets larger radius values and vice versa.

Example Use Cases

  • Coverage area visualization
  • Population density mapping
  • Regional impact analysis
  • Service radius representation

Notes

  • Circle size is dependent on the configured radius value.
  • Very large radius values may overlap across nearby locations.

 

Map Info Window

Overview

The Map Info Window formatter displays Tooltip/additional information when users interact with plotted locations.

Below are the available options to set the tooltip options.

Use Cases

  • Display measure values
  • Show location details
  • Provide contextual geographical information

Benefits

  • Improves interactivity
  • Enhances map readability
  • Helps users analyze plotted data points effectively

 

Zoom In-Zoom-Out (+/- Options on chart):

The +/- button on chart allows you to zoom in and out the chart. Same is allowed with mouse scroll up-down keys.

 


    • Related Articles

    • Creating a Map Widget

      In RubiSight, you can create a map widget if your dataset contains geographical variables. Geographical Variable In RubiSight, a new variable type called geographical is added to represent a location. It is supported for the below-listed location ...

    • Google Spreadsheet

      You can create a dataset using the data stored in your Google Spreadsheet. This feature is especially useful when you have huge volumes of data online. With this feature, you are not required to download the data. Rubiscape can directly connect to ...

    • Google Big Query

      Google Big Query is a serverless architecture. It lets you query huge amounts of data and provides desired results in seconds. It helps you to manage and analyse your data with built-in features. Prerequisites for a Google Big Query are: Google Cloud ...

    • Widget List

      The Widget List option is present in the Widget pane, next to Widgets and Format tabs. The Widget List is used to display the list of plotted widgets on a Dashboard page in a particular sequence. The last plotted widget appears first in the list, ...

    • Widget Filter

      Widget filters are activated when we click on a particular widget; that is, they are applied only to the selected widget. To apply widget filters, follow the steps given below. Create the number of charts as required. Refer to Creating Charts using ...