(See installation at the end of the README file)
- Download the sources
- Try the demo
- See mapshup in video or take a look at the Keynote
- Follow mapshup on Twitter
Mapshup provides an innovative and efficient access to Geospatial web services. It brings on an unique map a mashup of different services - Earth Observation data catalogs, OpenStreetMap/Bing/Google maps services, news feed, wikipedia articles, photos and videos from social networks, etc. - to easily build a comprehensive "information context" and help decision making for end users.
Mapshup is based on standard web technologies (i.e. javascript/css/HTML5). The user interface is designed to work both on desktop and on touch devices through a web browser.
It is able to connect to a large range of services including : OpenStreetMap/Bing/Google maps, OGC services (WMS, WFS, CSW and WPS), Earth Observation catalogs (ESA G-Pod catalog, ESA HMA catalogs, OpenSearch catalogs), Google Earth plugin, Google Streetview, Google Elevation, Flickr API, Youtube API, Wikipedia API, Geonames, RSS and Atom feeds, MapBox mbtiles, Pléiades metadata, Sentinel 2 metadata.
Out of the box functionalities include : auto-detection of data layers through drag&drop of files and/or urls to the map, 2D and 3D support, content creation, context saving and sharing through email/facebook/twitter.
The user interface is "map centric". All information is displayed within the map wich represents 100% of the view excepted for the top header bar wich contains generic actions (a free text search input form, the map backgrounds switcher, the share button, the help button, the login information).
The user interface is designed to be easy to use on touch devices. As a consequence every functionality is accessible through one single touch and "hidden" menu are avoided as possible, making the user experience very intuitive
Note: the following scripts only work on Linux or Mac OS X
Before installing, you need to double check that the following packages are installed :
- Apache server
- PHP > 5.0
- PHP Curl
- PHP XML package
- PostgreSQL > 8.3 (optional - for UserManagement and context sharing only)
- PostGIS > 1.5 (optional - for UserManagement and context sharing only)
- Mapserver > 5.0 (optional - for on the fly WMS reprojection only)
Note: to get these packages installed you can take a look at https://github.com/jjrom/GisOnOsX/blob/master/README.md (Mac OS X) or at https://github.com/jjrom/InstallALinuxServerForMapshup/blob/master/README.md (Linux)
In the following, we suppose that
- $MAPSHUP_SRC is the directory where mapshup sources will be installed
- $MAPSHUP_TARGET is the directory where mapshup will be installed. This directory should be under Apache root directory
Retrieve sources
git clone https://github.com/jjrom/mapshup.git $MAPSHUP_SRC
Build mapshup
/bin/rm -Rf $MAPSHUP_TARGET
$MAPSHUP_SRC/build.sh -t $MAPSHUP_TARGET -c $MAPSHUP_SRC/client/js/mapshup/config/example.js
Install database (optional - for UserManagement and context sharing only)
# Edit install_mapshupdb.sh to put the right postgis paths if needed
# See $MAPSHUP_TARGET/s/README_INSTALL.txt
cd $MAPSHUP_TARGET/s/_installdb
./install_mapshupdb.sh
Configuration
Edit $MAPSHUP_TARGET/s/config.php Note : the current build suppose that mapshup directory is accessible through http://localhot/mapshup. If it is not the case, change it within $MAPSHUP_TARGET/js/mapshup/config/example.js