A modern, free and open-source web mapping application with built-in migration support for legacy Flex Viewer applications.
In June 2016 Viewer for Flex was discontinued with no clear migration path for existing applications. Maple was born out of the necessity to provide such migration path. Our goals have been to:
- Allow an organization to continue using Viewer for Flex while the issues of a new application development are sorted out.
- Keep configurations between the legacy application and the new application in sync, allowing for a transition period in which both applications can be available to users.
As a result of such goals, the configuration files in Maple have a 1-to-1 correspondence to those of legacy Flex applications.
A tool that automates the migration of legacy configuration files is available at https://maple.virtualgis.io
Users can also write the configuration files for new projects manually or use one of the many XML to JSON converters to convert their existing projects.
- Hello United States. A simple public map showcasing LayerList, eMapSwitcher and Bookmark widgets.
- Construction Demo. A more complex configuration featuring user-based authentication (via the built-in user store) and showcasing LayerList, Legend, eMapSwitcher, Bookmark, Search, Locate, ElevationProfile, WMSLooping, Print, Query, ImportDataFile, Link, Measure, eDraw widgets.
- Install and configure a web server of your choice (Windows users can use XAMP, which also installs PHP).
- Install and configure PHP.
- Download the latest version of Maple and extract it in the root folder of your web server.
- Go to http://localhost to make sure the default application loads.
- Change the configuration files in
config/projects/defaultfor your application (documentation coming soon).
Getting Started wih Docker
If you have Docker you can simply run:
docker run -d -p 80:80 -v path/to/your/config:/var/www/html/config/projects/default virtualgis/maple
Then open a web browser to http://localhost.
Creating Configuration Files
Currently looking at the existing configuration examples in
config/projects is the easiest way to learn how to write configuration files for Maple.
A tool that automatically migrates configuration files coming from a legacy Flex Viewer application will also be available soon, so that you don't have to do it by hand.
We currently support the following widgets:
- ConfigSelectSplash (Maple has support for multiple profiles)
If you don't see one that you need in this list, open an issue to request it.
The best source of documentation is currently to look at the examples. We are planning to expand our documentation in the upcoming months.
Support the Project
There are many ways to contribute back to the project:
- Help us test new and existing features and report bugs and feedback.
⭐️us on GitHub.
- Spread the word about Maple on social media.
- While we don't accept donations, you can purchase a premium support contract.
- Become a contributor.
The easiest way to get started is to take a look at our list of outstanding issues and pick one. You can also fix/improve something entirely new based on your experience with Maple. All ideas are considered and people of all skill levels are welcome to contribute.
You don't necessarily need to be a developer to become a contributor. We can use your help to write better documentation and improve the user interface texts and visuals.
If you have questions come to Gitter and we'll be happy to help you out with your first contribution.
The reason for selecting the AGPL v3.0 as our open source license is to require that enhancements to Maple be released to the community. Traditional GPL often does not achieve this anymore as a huge amount of software runs in the cloud.
If use of the AGPL v3 does not satisfy your organization’s legal department (some will not approve GPL in any form), commercial licenses are available. Feel free to contact us for more details.
ESRI Licensing and Attribution
Maple is in no way affiliated with, authorized, maintained, sponsored or endorsed by ESRI or any of its affiliates or subsidiaries.
- Unit Testing
- ES6 support
- Upgrade ESRI API to version 4
- Support for more widgets
Some icons have been modified from IcoMoon - Free CC BY 4.0.