Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gluonhq/maps
https://github.com/gluonhq/maps
java javafx map
Last synced: 7 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/gluonhq/maps
- Owner: gluonhq
- License: gpl-3.0
- Created: 2016-09-23T07:04:11.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-07-29T12:21:12.000Z (7 months ago)
- Last Synced: 2025-02-06T01:56:56.714Z (14 days ago)
- Topics: java, javafx, map
- Language: Java
- Homepage: https://gluonhq.com/labs/maps/
- Size: 523 KB
- Stars: 146
- Watchers: 14
- Forks: 35
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- aboutfx - Gluon Maps
README
[](https://gluonhq.com)
[](https://github.com/gluonhq/maps/actions/workflows/build.yml)
[](https://search.maven.org/#search|ga|1|com.gluonhq.maps)
[](https://opensource.org/licenses/GPL-3.0)
[](https://javadoc.io/doc/com.gluonhq/maps)
[](https://www.jfx-central.com/libraries/gluonmaps)# Gluon Maps
Gluon Maps provides an easy way to integrate [OpenStreetMaps](https://www.openstreetmap.org) into a JavaFX application.
It is blazing fast and offers layer overlays, multiple tile-sets, and much more.## API Overview
### MapPoint
Represents a set of latitude and longitude values.```
MapPoint point = new MapPoint(latitude, longitude);
```### MapLayer
Shows the map tiles along with any user defined nodes.
This class can be extended by overloading the `layoutLayer` method.The following code snippet shows how to create a custom layer that displays red circles at the given map points:
```
public class CustomMapLayer extends MapLayer {@Override
protected void layoutLayer() {
for (Pair candidate : points) {
MapPoint point = new MapPoint(lat, long);
Node icon = new Circle(5, Color.RED);
Point2D mapPoint = getMapPoint(point.getLatitude(), point.getLongitude());
icon.setVisible(true);
icon.setTranslateX(mapPoint.getX());
icon.setTranslateY(mapPoint.getY());
}
}
}
```### MapView
Top level map component which supports multiple `MapLayer`.
The section of viewable map can be changed using input events (mouse/touch/gestures),
or by calling the methods `setCenter` and `setZoom` directly.```
MapView mapView = new MapView();
mapView.addLayer(new CustomMapLayer());
mapView.setZoom(3);
```## Usage
`Map` can be added to a JavaFX project by using the artifact published in Maven Central:
Maven:
```com.gluonhq
maps
${version}```
Gradle:
```
dependencies {
implementation 'com.gluonhq:maps:${version}'
}
```The project can be also be installed in the local Maven repository:
```
mvn install
```## Sample
A [sample](https://github.com/gluonhq/maps/tree/master/samples/) is provided in the repository to get started with the library.
To run the sample:
```
mvn javafx:run -f samples
```## Contribution
All contributions are welcome!
There are two common ways to contribute:
- Submit [issues](https://github.com/gluonhq/maps/issues) for bug reports, questions, or requests for enhancements.
- Contributions can be submitted via [pull request](https://github.com/gluonhq/maps/pulls), provided you have signed the [Gluon Individual Contributor License Agreement (CLA)](https://cla.gluonhq.com).Follow [contributing rules](https://github.com/gluonhq/maps/blob/master/CONTRIBUTING.md) for this repository.
## Commercial License
Commercial licences available at: http://gluonhq.com/labs/maps/buy/