MapPush is a simple web application that draws realtime events on a geomap using the Comet/WebSocket protocols. It was created to illustrate the Atmosphere framework's capabilities and ease of use.
User can trigger events by clicking on the map, and server can generate random events. A generated event (by either client or server) is delivered to each connected clients via available protocols.
Both web client and server use the Atmosphere Framework to handle and broadcast realtime events. In addition, the web client uses Leaflet library with MapQuest OSM tiles; its GUI was built using Bootstrap and jQuery libraries.
For more information about this project, please read the Come/WebSocket? Introducing the Atmosphere framework blog post.
A demonstration video is also available on Youtube.
To launch this project, proceed as following:
- Clone the project
git clone git@github.com:ncolomer/MapPush.git(you need git) - Deploy the webapp on Jetty8 using the Maven command
mvn jetty:run(you need Maven)
You are now able to connect as many tab of your favorite browser you want to http://localhost:8080/MapPush.
You may also want to use the following shell commands to play with the exposed API:
# Connect to the WebSocket URI
boundsHeader='48.0,49.0,2.0,3.0'
curl -v -N -X GET http://localhost:8080/MapPush/api -H "X-MAP-BOUNDS: $boundsHeader"
# Send an event
event='{"lat":48.921266,"lng":2.499390}'
curl -v -X POST http://localhost:8080/MapPush/api/event -d $event -H "Content-Type: application/json"