Fork me on GitHub

Maven Central Build Status Test Status Coverage

Introduction

MapView is a simple JavaFX 2 control that can render a tile-based map. It offers the following features:

  • zooming in/out
  • dragging
  • centering on double click
  • rendering overlays, such as GPS tracks

image

It works with map systems based on the Mercator projection, such as OpenStreetMap or OpenTopoMap.

image

To get started, look at the example in the code and the Javadoc. To run the example launch:

mvn install
mvn -f modules/Example/pom.xml exec:java

As an historical note, MapView has been derived by Windrose, an old open source GPS navigation project for Java Mobile developed by the same author between 2006 and 2008 (even though in the end only a few lines of code have been retained).

MapView has been developed because a map viewer is needed by a project of the same author and the existing similar components for JavaFX, at the end of 2024, seem to be abandoned or not working. If you need a bug fix or an enhancement, requests, contributions such as patches, pull requests etc… are welcomed.

MapView is licensed with the Apache license.

General information

Artifact coordinates

To use MapView in your Maven project, use the following POM snippet:

<dependency>
  <groupId>it.tidalwave.mapview/groupId>
  <artifactId>mapview-javafx</artifactId>
  <version>${mapview.version}</version>
</dependency>

For other build systems, see this document.

Sources, issue tracker and continuous integration

The primary source repository is on Bitbucket; a secondary repository (synchronized in real time) is available on GitHub.

To checkout sources from Bitbucket:

git clone https://bitbucket.org/tidalwave/mapview-src

To checkout sources from GitHub:

git clone https://github.com/tidalwave-it/mapview-src

The issue tracker is hosted on the Atlassian Jira Cloud:

The continuous integration is available at:

API documentation

Javadoc