Java API for using Google Maps within a JavaFX application.
rterp Merge pull request #151 from mrLordiz/master
added support for route alternatives
Latest commit 4623d3f Mar 28, 2018


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.] (



Apache License, Version 2.0 (current)

Also, please be aware, in order to use this library, you must also accept the Google Terms of Service.