gwt-leaflet

A lightweight mapping alternative to popular mapping APIs like Google Maps and OpenLayers.

The library uses Leaflet, an open-source javascript library for mobile-friendly interactive maps by CloudMade, to implement a collection of mapping Widgets which GWT projects can use to implement mapping capabilites on the client-side of a GWT application. The Leaflet API is a third-party javascript and is integrated with GWT as Java classes using JSNI and Type Overlays.

Features

Warning: This project is in flux. API, module structure and names can change at any time!

###Milestones###

• v0.1 (Medio Sep 2012) - Core parts of Leaflet API exposed
• v0.2 (Primo Nov 2012) - All relevant parts of Leaflet API exposed, start publishing snapshots (maven + jars)
• v0.3 (Ultimo Dec 2012) - Widgets: geolocation (field), first official release (maven + jars).

###Core Module###

Dependency: Leaflet 0.4.5

Following parts of Leaflet API are implemented:

• L.Map - Leaflet Map class (partial)
• ILayer - Common layer interface
• L.TileLayer - Common Tile layer class
• L.TileLayer.WMS - WMS layer class
• IControl - Common control interface
• L.Control.Layers - Layer switcher control class
• L.Control.Attribution - Map and layer attribution class
• L.Control.Scale - Simple legend control class
• L.Control.Zoom - Simple zoom control class
• L.Point - Map point (coordinates in pixels)
• L.LatLng - Geographical point
• L.Transformation - Affine transformation
• ICRS - Coordinate reference system interface
• L.CRS - Base CRS class
• L.CRS.EPSG3395 - EPSG:3395
• L.CRS.EPSG3857 - EPSG:3857
• L.CRS.EPSG4326 - EPSG:4326
• L.CRS.Simple - Simple CRS (lat and lng into x and y directly)

###Widget Module (GWT)###

• MapWidget - GWT Widget displaying a Map instance (available from WindowBuilder Editor palette)

###Proj4 Module (GWT)###

Dependency: Proj4Leaflet master/74a5a8b170ff58e635cba139cfaa25cd4cd5d022 (git)

• Proj4 - Custom (local) CRS factory plugin to Leaflet (Proj4Leaflet)

###Search Module (GWT)###

Dependency: leaflet-search master/3b717c6ff2bbd5ad19ba4f851c152f67ca62b97d (git)

• Leaflet Search - Simple search plugin for Leaflet (leaflet-search)

###Label Module (GWT)###

Dependency: Leaflet.label master/3c13acff459c36a222e9fdefd718af95396a0a9f (git)

• Leaflet label - Simple label plugin for Leaflet (Leaflet.label)

Example

Goto gwtl-example.appspot.com to see a running example of the GWT example project.

Development

This Git project structured as a Maven multi-gwt-module project setup, (see working with maven) and is developed using

• Maven (3.0.4)
• Maven GWT Plugin - automatically downloaded by maven
• Eclipse IDE for Java Developers (3.7.2)
• Google Eclipse Plugin
• Window Builder Pro
• EGit
• Maven Integration for Eclipse 1.2
• Maven Integration for Eclipse WTP (Incubation) 0.16.0

Ensure that these are all installed and ready before you continue. To install from scratch, just

1. Download and install Eclipse
2. Download P2 software file import file and start Eclipse
3. Open File -> Import -> "Install Software Items from File" wizard
4. Enter path to p2f file downloaded in step 2
5. Check "Contact all update sites during install to find required software"
6. Press enter and follow the instructions.

When you are all done, just (linux)

7. fork this repo on github
8. clone the fork locally - git clone https://github.com/<username>/gwt-leaflet.git
9. change directory to - cd gwt-leaflet/src
10. and run the command - mvn package

which should automatically download some stuff for you and prepare the projects for import into Eclipse.

11. Switch to Eclipse and select File -> Import...
12. Select Maven -> Existing Maven Projects
13. Select Browse ... -> gwt-leaflet/src
14. Finish

which should import all projects into current workspace.

Reference

You find more information in the developer guide.