Skip to content

ncolomer/MapPush

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MapPush

MapPush client screenshot

Kesako?

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.

Try it!

To launch this project, proceed as following:

  • Clone the project git clone [email protected]: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"