Google Maps Plugin

Stable Version 3.0.0 (OutSystems 10)
Published on 04 August 2017 by 
Created on 07 March 2017
Google Maps Plugin for Cordova
Read More

*** The all new performant Google Maps Plugin for your mobile applications.***

This plugin uses native Google Maps rendering engine which is outruns javascript implementation in both performance and reliability.


1) Get the API Keys for Android and IOS using the instructions available on the plugin page: (sections 4a and 4b)

2) Configure the API Keys under Extensibility Configurations under the Advanced section of the GoogleMapsPlugin module's root settings, replacing <Your API Key> by the corresponding key. Please note when creating the keys they may have certain requirements like being exclusive to IOS or Android, or being tied to a specific bundle id or signing certificate SHA1 fingerprint.

Notes on usage

  • In terms of webview rendering, there are some special characteristics to this plugin. It tracks for touch events outside the context of the webview, therefore some considerations need to be taken into consideration when defining the interactions in pages which are using this plugin.
    • Elements which are defined inside the OverlayContent have touch events tracking, therefore you can logic inside the map canvas here;
    • Elements outside the map, which render over the map area, do not track touch events, so you need to use a special JavaScript action (map.setClickable(true/false)) to disable touch events on the map;
    • This is specially important in the case of OutSystem's menus, which render on top, and for which we don't have a specific means to trap the opening/closing event, so recommendation is to either rely on bottom bar navigation, or to use the Back button instead of the menu option.
  • The plugin is resource intensive, therefore it only supports one map per page. If you need more than one map, please use the Google Maps Mobile plugin, which uses Google's JavaScript API.
  • On IOS the plugin requires a special setting for the status bar, that needs to be defined in your eSpace for the map overlay to match the placeholder for the map:
    If you need to redefine this setting, you will probably need to adjust the placement of the Map div, as described in this GitHub Wiki page.

Special notes on future versions

All feedback is welcome, please reach out!



Apache 2.0

What’s new (3.0.0)

Support for multiple maps in one screen.

Beware interaction is not perfect when adding this map on a scrollable page. Check GoogleMapsDemo for reference.

Reviews (0)
Mobile Plugins
Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Grazina who created this component.
See all 2 dependencies
Component Consumers
See all 1 consumers
Weekly Downloads 
Related Components
Event System
Use custom events in your OutSystems apps! Communicate events instantly between web blocks, refactor your screen logic, use divide-and-conquer for complex forms, build reusable components, and much more. And do all of these with a beautifully simple API.
Google Maps
Google Maps is a Google Maps Javascript V3 API component, providing Web Blocks and Actions to add interactive maps, markers and directions, along with event driven functionality.
Infrastructure Monitor
A LifeTime plugin to provide Developers and Operations a quick and simple infrastructure monitoring tool for the platform servers. It will help you keep your infrastructure in check by surfacing key performance metrics of your servers and alert you when these metrics reach thresholds that may compromise the performance or stability of your environments. Instructions here:
More from Grazina
Ricardo Pereira
Using the newest API from Amazon, this extension allows access to AmazonS3 basic functions in a simple manner.
FullCalendar 2
A complete and interactive calendar supporting multiple views, different event sources and advanced customization
IBM Watson IoT
IBM Watson IOT Team
Connector for IBM Watson IoT Hub that allows to receive stream data from devices and to send messages to control devices.