Skip to content

mikey75/jmaps

Repository files navigation

Maven Central License: MIT CI Last commit

Java Swing component to display and interact with online maps.

  • Supports OpenStreetMap style slippy maps
  • Supports WMTS maps
  • Supports QUAD tile maps (e.g virtual earth)
  • Supports most CRS projections (via proj4j)
  • Supports multiple layer maps with transparency/zoom offsets
  • Comes with example application and example map definitions.
  • Supports user overlays - you can plot anything on the map (waypoints, GPS tracks etc)
  • Supports caching (file-based, in-memory database or Redis) of map tiles with configurable timeout

For changes always look at ReleaseNotes.txt

Usage:

      <dependency>
        <groupId>net.wirelabs</groupId>
        <artifactId>jmaps-viewer</artifactId>
        <version>$version/version>
      </dependency>

Latest version can be checked here on the top bar maven status icon.

!!! Warning !!!

Version 1.3 introduced a tiny error, that makes using map sources that have space in query params unusable.
Details are in Issue #49. Fix is already in 1.4.0 version. Do not use version 1.3 if you have such map sources.

Samples:

jMaps comes with sample demo application. It is also an example of using the jMaps component in your own application.
Here's a few pictures telling thousand words ;)

  • WMTS Map of Czech Republic sample1
  • Poland raster topographic WMTS map sample2
  • OpenStreetMap with loaded GPX track sample3
  • Example of multilayer map (2 layers - one is a base topo map, the other is elevation profile). You can enable/disable given layer from the view. sample4
  • Virtual Earth Maps (example of quad tiles) sample5

Running example app locally

There are two quick-run scripts included:

  • runExampleApp.bat for Windows
  • runExampleApp.sh for linux

Edit the java and maven locations and run the script for your OS.

Your JAVA variable in those scripts should point to java 17

About

Java Swing component to display and interact with web maps.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Languages