{"id":13798400,"url":"https://github.com/gluonhq/maps","last_synced_at":"2025-10-12T02:02:05.155Z","repository":{"id":12327020,"uuid":"68998594","full_name":"gluonhq/maps","owner":"gluonhq","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-29T12:21:12.000Z","size":536,"stargazers_count":148,"open_issues_count":20,"forks_count":35,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-03-24T05:09:55.240Z","etag":null,"topics":["java","javafx","map"],"latest_commit_sha":null,"homepage":"https://gluonhq.com/labs/maps/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gluonhq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-23T07:04:11.000Z","updated_at":"2025-03-09T15:09:04.000Z","dependencies_parsed_at":"2024-01-15T11:11:03.428Z","dependency_job_id":"f2ca1564-064d-429a-8c30-15a6824b4ccf","html_url":"https://github.com/gluonhq/maps","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluonhq%2Fmaps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluonhq%2Fmaps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluonhq%2Fmaps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gluonhq%2Fmaps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gluonhq","download_url":"https://codeload.github.com/gluonhq/maps/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246429469,"owners_count":20775806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","javafx","map"],"created_at":"2024-08-04T00:00:43.235Z","updated_at":"2025-10-12T02:02:00.123Z","avatar_url":"https://github.com/gluonhq.png","language":"Java","readme":"[![Gluon](.github/assets/gluon_logo.svg)](https://gluonhq.com)\n\n[![Build](https://github.com/gluonhq/maps/actions/workflows/build.yml/badge.svg)](https://github.com/gluonhq/maps/actions/workflows/build.yml)\n[![Maven Central](https://img.shields.io/maven-central/v/com.gluonhq/maps)](https://search.maven.org/#search|ga|1|com.gluonhq.maps)\n[![License](https://img.shields.io/github/license/gluonhq/maps)](https://opensource.org/licenses/GPL-3.0)\n[![javadoc](https://javadoc.io/badge2/com.gluonhq/maps/javadoc.svg)](https://javadoc.io/doc/com.gluonhq/maps)\n[![JFXCentral](https://img.shields.io/badge/Find_me_on-JFXCentral-blue?logo=googlechrome\u0026logoColor=white)](https://www.jfx-central.com/libraries/gluonmaps)\n\n# Gluon Maps\n\nGluon Maps provides an easy way to integrate [OpenStreetMaps](https://www.openstreetmap.org) into a JavaFX application.\nIt is blazing fast and offers layer overlays, multiple tile-sets, and much more.\n\n## API Overview\n\n### MapPoint\nRepresents a set of latitude and longitude values.\n\n```\nMapPoint point = new MapPoint(latitude, longitude);\n```\n\n### MapLayer\nShows the map tiles along with any user defined nodes.\nThis class can be extended by overloading the `layoutLayer` method.\n\nThe following code snippet shows how to create a custom layer that displays red circles at the given map points:\n\n```\npublic class CustomMapLayer extends MapLayer {\n\n    @Override\n    protected void layoutLayer() {\n        for (Pair\u003cMapPoint, Node\u003e candidate : points) {\n            MapPoint point = new MapPoint(lat, long);\n            Node icon = new Circle(5, Color.RED);\n            Point2D mapPoint = getMapPoint(point.getLatitude(), point.getLongitude());\n            icon.setVisible(true);\n            icon.setTranslateX(mapPoint.getX());\n            icon.setTranslateY(mapPoint.getY());\n        }\n    }\n}\n```\n\n### MapView\nTop level map component which supports multiple `MapLayer`.\nThe section of viewable map can be changed using input events (mouse/touch/gestures),\nor by calling the methods `setCenter` and `setZoom` directly.\n\n```\nMapView mapView = new MapView();\nmapView.addLayer(new CustomMapLayer());\nmapView.setZoom(3);\n```\n\n## Usage\n\n`Map` can be added to a JavaFX project by using the artifact published in Maven Central:\n\nMaven:\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.gluonhq\u003c/groupId\u003e\n    \u003cartifactId\u003emaps\u003c/artifactId\u003e\n    \u003cversion\u003e${version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nGradle:\n```\ndependencies {\n    implementation 'com.gluonhq:maps:${version}'\n}\n```\n\nThe project can be also be installed in the local Maven repository:\n\n```\nmvn install\n```\n\n## Sample\n\nA [sample](https://github.com/gluonhq/maps/tree/master/samples/) is provided in the repository to get started with the library.\n\nTo run the sample:\n\n```\nmvn javafx:run -f samples\n```\n\n## Contribution\n\nAll contributions are welcome!\n\nThere are two common ways to contribute:\n\n- Submit [issues](https://github.com/gluonhq/maps/issues) for bug reports, questions, or requests for enhancements.\n- 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).\n\nFollow [contributing rules](https://github.com/gluonhq/maps/blob/master/CONTRIBUTING.md) for this repository.\n\n## Commercial License\n\nCommercial licences available at: http://gluonhq.com/labs/maps/buy/\n","funding_links":[],"categories":["Community"],"sub_categories":["Libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgluonhq%2Fmaps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgluonhq%2Fmaps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgluonhq%2Fmaps/lists"}