Codename One Google Native Maps Support

Allows Codename One developers to embed native Google Maps on iOS/Android or fallback to Codename One MapComponent on other platforms. Check out a brief tutorial on using this project here: https://www.codenameone.com/blog/new-improved-native-google-maps.html

Limitations

1. The native maps are only supported on Android devices that have the Google Play store (e.g. not on Amazon Kindle) and on iOS devices. All other devices will show the MapComponent by default. Map component will be used on the simulator as well.

2. Since a native component is used placing overlays is problematic. You will need to use Dialogs and the API's of the MapContainer class to implement this.

Configuration

The configuration portion is the hardest part, Google made it especially painful in the Google typical way. You can follow the instructions from Google to get started for Android, for iOS, and for Javascript. UWP uses https://code.msdn.microsoft.com/windowsapps/Bing-Maps-for-Windows-10-d7ae3e44[BingMaps] instead of Google maps.

You will need to follow their instructions to generate your map keys. Then define the following build arguments within your project:

javascript.googlemaps.key=YOUR_JAVASCRIPT_API_KEY
android.xapplication=<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_ANDROID_API_KEY"/>
ios.afterFinishLaunching=[GMSServices provideAPIKey:@"YOUR_IOS_API_KEY"];

Make sure to replace the values YOUR_ANDROID_API_KEY, YOUR_IOS_API_KEY``, and YOUR_JAVASCRIPT_API_KEY with the values you obtained from the Google Cloud console by following the instructions for Android , for iOS, and for Javascript.

NOTE: You can specify the iOS Google Maps version by setting the var.ios.pods.GoogleMaps.version build hint, using Cocoapods version syntax. The default value is currently ~> 3.8. If you wish to use a newer version (e.g. 3.8), then you'll need to set your ios.pods.platform build hint to a higher version, as newer versions of GoogleMaps have higher iOS version requirements. ~> 2.0 requires iOS 8 or higher. ~> 3.8 requires iOS 9.

For UWP, you'll need to define the windows.bingmaps.token display property inside your app's init() method to your Bing Maps token. See instructons on generating a BingMaps token. E.g.

Display.getInstance().setProperty("windows.bingmaps.token", "xxxxxxxxx");

NOTE: Version 23 and higher require google play services 9.4.0 or higher, this library will automatically cause your app to build against 9.4.0 or higher. If you require compatibility with the older version (8.3.0), you'll need to install GoogleMaps.cn1lib v22 or earlier. You can download v22 here.

This project was migrated from an old project on Google code http://code.google.com/p/codenameone-google-maps