2017-03-07
1.0.0
Grazina
10.0.200.2
All
All
Plug-ins
[Overview]
Google Maps Plugin for Cordova
[Detail]
*** 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.
Notes on usage
In order to use this plugin, you need to set your Google Maps API key on the plugin's espace Extensibility Configuration
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 is defined in the actual plugin:
StatusBarOverlaysWebView=true
If you need to redefine this setting, you will probably need to adjust the placement of the Map div, as descrived in this GitHub Wiki page.
Special notes on future versions
The plugin is using Google Directions service in order to render directions. Expect this function to be deprecated in the future in favour of a composition of the Polygon rendering and a new Google Directions Forge component to be announced
We're using a special branch of mapsplugin/cordova-plugin-googlemaps (multiple_maps branch), which has performance improvements and promised some special features which are not ready yet. (this wiki details the improvements from the master branch)
All feedback is welcome, please reach out!
Credits
https://github.com/masashiGMS
Licensing
Apache 2.0