jiubadao / gmapsfx

Java API for using Google Maps within a JavaFX application.

GMapsFX

Fixed! Attention: Known Issue, Garbled Text in GMapsFX on Mac OSX

A pure JavaFX API which allows you to add Google Maps to your JavaFX application without the need to interact with the underlying Google Maps JavaScript API.

GMapsFX requires Java 8

Quick Start

Build the framework

$ mvn install

Run the sample application

$ mvn exec:java

Development Notes

The GMapsFX framework creates underyling JavaScript peer objects when their corresponding Java objects are instantiated. For example when a new com.lynden.gmapsfx.javascript.object.LatLong object is created, the object's constructor will also create a corresponding LatLong object in the JavaScript environment.

Because of this it is important to note that you cannot instantiate JavaScript objects until the JavaScript engine has been fully initialized. The JavaScript engine is intialized asynchronously when a new GoogleMapView component is created. You can register a MapComponentInitializedListener to be notified when the map and JavaScript environment has been fully initialized.

You can take a look at a small example code snippet here.

The latest Javadocs can be found [here.] (http://rterp.github.io/GMapsFX/apidocs/)

Authors

• Rob Terpilowski :: Twitter: @RobTerpilowski
• Geoff Capper

License

Apache License, Version 2.0 (current) http://www.apache.org/licenses/LICENSE-2.0

Also, please be aware, in order to use this library, you must also accept the Google Terms of Service. https://developers.google.com/maps/faq#understanding-terms-of-service