https://github.com/mikey75/jmaps

Java Swing component to display and interact with web maps.
https://github.com/mikey75/jmaps

cartography component gis gpx java maps online-maps openstreetmap osm swing tracking webmaps wmts

Last synced: 2 months ago
JSON representation

Java Swing component to display and interact with web maps.

• Host: GitHub
• URL: https://github.com/mikey75/jmaps
• Owner: mikey75
• Created: 2023-05-20T08:54:11.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2025-12-02T16:03:06.000Z (4 months ago)
• Last Synced: 2025-12-05T11:38:08.137Z (4 months ago)
• Topics: cartography, component, gis, gpx, java, maps, online-maps, openstreetmap, osm, swing, tracking, webmaps, wmts
• Language: Java
• Homepage:
• Size: 12.4 MB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
![Maven Central](https://img.shields.io/maven-central/v/net.wirelabs/jmaps)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![CI](https://github.com/mikey75/jmaps/actions/workflows/maven-build.yml/badge.svg)

![Last commit](https://img.shields.io/github/last-commit/mikey75/jmaps)

# 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: 

          

            net.wirelabs

            jmaps-viewer

            $version/version>

          

          

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.](https://github.com/mikey75/jmaps/issues/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](images/1.png "Sample 1")

- Poland raster topographic WMTS map

![sample2](images/2.png "Sample 2")

- OpenStreetMap with loaded GPX track

![sample3](images/3.png "Sample 3")

- 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](images/4.png "Sample 4")

- Virtual Earth Maps (example of quad tiles) 

![sample5](images/5.png "Sample 5")

# Running example app locally

Your JAVA_HOME should point to java 17:

```

cd jmaps-viewer && mvn clean install && cd ..

cd jmaps-example && mvn clean package && cd ..

cd jmaps-example && java -jar target/jmaps-example.jar