Google Maps Plugin

Stable Version 3.0.0 (OutSystems 10)
Published on 04 August 2017 by 
Created on 07 March 2017
Details
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.

Installation

1) Get the API Keys for Android and IOS using the instructions available on the plugin page: https://github.com/mapsplugin/cordova-plugin-googlemaps/wiki/Phonegap-Usage (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:
    StatusBarOverlaysWebView=true
    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!

Credits

https://github.com/masashiGMS

Licensing

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)
Category
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.
Dependencies
See all 2 dependencies
Requirements
Platform
10.0.0.402
Database
All
Stack
All
Component Consumers
See all 1 consumers
Weekly Downloads 
Related Components
Event System
leonardo.fernandes
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.
1552
Google Maps
Labs
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.
12376
Infrastructure Monitor
Experts
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: http://outsyste.ms/1lnELXb
368
More from Grazina
AdvancedAmazonS3
Ricardo Pereira
Using the newest API from Amazon, this extension allows access to AmazonS3 basic functions in a simple manner.
655
FullCalendar 2
Grazina
A complete and interactive calendar supporting multiple views, different event sources and advanced customization
1602
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.
67