Google Maps Plugin
Stable Version 3.0.0
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 Plug-ins
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
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.
10592
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.
1385
Chosen
Miguel 'Kelter' Antunes
Chosen is a jQuery plugin that makes long, unwieldy select boxes much more user-friendly.
883
More from Grazina
AdvancedAmazonS3
Ricardo Pereira
Using the newest API from Amazon, this extension allows access to AmazonS3 basic functions in a simple manner.
603
FullCalendar 2
Grazina
A complete and interactive calendar supporting multiple views, different event sources and advanced customization
1299
Oracle connector
Francisco Menezes
Oracle connector allows you to extend your app using Store Procedures or Functions of an Oracle DB
576