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
Via Codename One Preferences
- Open Codename One Preferences (i.e. Control Center)
- Go to "Advanced Settings" > "Extensions" in the menu.
- Find the "Codename One Google Native Maps" option.
- Press "Download"
Back in your IDE (e.g. IntelliJ, NetBeans, Etc..) select the "Refresh Cn1libs" option in the Codename One menu.
If you are using Maven as your build tool, then you can simply paste the following snippet into your common/pom.xml file:
<dependency> <groupId>com.codenameone</groupId> <artifactId>googlemaps-lib</artifactId> <version>1.0.2</version> <type>pom</type> </dependency>
NOTE: You should replace the
version with the latest on Maven central.
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.
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.
This library requires a few build hints in order to work properly. Most of these are used to set the Google Maps API keys for the various target platforms. You can use the Codename One Simulator's built-in Built-hint editor to add these build hints. All you need to do is add an instance of
MapContainer in your app's source, then launch the simulator.
In the Tools menu, select Edit Build Hints...
This will open a Build Hint Editor window as shown below:
TIP: If don't see the "Google Maps" tab in your build hint editor, then your app hasn't tried to load a
MapContainer instance yet. Close the build hint editor, then navigate to the part of your app where you show a
MapContainer. Then open the Build Hint editor again.
The build hint editor will include four fields in the Google Maps section:
- Android Minimum SDK Version
The fields will initially be blank, however, most fields will include an "Example" field just below it that includes some sample content that can be copied and pasted into the corresponding field as a starting point. Some of the fields (e.g. ios.afterFinishLaunching and android.xapplication) include placeholder text that you need to replace with your API key.
Obtaining API Keys
Below each of these fields, you'll see a "Get Key" button. Each of these will open the associated Google web page with instructions on generating your key.
UWP uses BingMaps instead of Google maps.
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.
iOS Pod Version
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.
Building From Source
This project uses Maven as its build tool.
git clone https://github.com/codenameone/codenameone-google-maps cd codenameone-google-maps/GoogleMaps mvn install
This will install the library into your local maven repository so that you'll be able to add it as a dependency to any of your projects with the snippet:
<dependency> <groupId>com.codenameone</groupId> <artifactId>googlemaps-lib</artifactId> <version>THE_VERSION</version> <type>pom</type> </dependency>
THE_VERSION with the version in the GoogleMaps/pom.xml file.
IMPORTANT: Notice that you include the
googlemaps-lib artifact and not the
googlemaps artifact when using it as a dependency. The root "googlemaps" artifact is just a wrapper project for the multi-module project. The "lib" module is the actual cn1lib dependency.
Building Legacy .cn1lib File
Maven projects no longer use .cn1lib file format, however the project still builds this format in case you want to distribute the cn1lib without using Maven's dependency mechanisms (or if you want to use the library with the legacy Ant project type). When you run
mvn install it will automatically build the cn1lib file. You'll find it inside the common/target directory after performing a build.