Simcoe County OpenLayers Map Viewer
Live beta site can be found here
The goal of this project is to replace this viewer using an open source environment. The existing viewer is built using the ESRI 3.x JS api/DOJO with the Web App Builder and ArcGIS Server.
This app is built using React, OpenLayers and GeoServer. Many components are configurable to point to your own WMS/WFS, XYZ services. Some components use a custom rest api, such as the search and property report.
GeoServer Server Rest API end points need to be enabled for this app to work!
It's built using a framework to easily create your own tools and themes (instructions below) using the provided templates. Control what layers, tools and themes are loaded using the config at the root of the src folder.
The Table of Contents (layers tab) utilizes groups in GeoServer.
Heads up. This project is not complete and missing many components but the "core" framework and design is in place. New functionality will be posted to the beta site above.
Contributions are welcome. Even if you only clone it and add tools to your own project, please share them back and I'll integrate them if useful.
This app works in conjunction with these supporting projects.
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Prerequisites
Node JS
Installing
git clone https://github.com/county-of-simcoe-gis/SimcoeCountyWebViewer.git
cd SimcoeCountyWebViewer
npm install
npm start
Deployment
In the project diretory, type npm run build in the terminal. Details can be found with Create React App
To create a new tool
- Create new directory for tool in 'src/sidebar/components/tools/yourToolName'
- Copy template files into the previous directory from 'src/componentTemplate/ToolComponent.jsx' and 'src/componentTemplate/toolComponent.css
- Rename the files to your component name (case sentive)
- Add tool to the main config in 'src/config.json'. Copy existing tool text in the config, for an example.
To create a new theme
- Create new directory for theme in 'src/sidebar/components/theme/yourThemeName'
- Copy template files into the previous directory from 'src/componentTemplate/ThemeComponent.jsx' and 'src/componentTemplate/themeComponent.css
- Rename the files to your component name (case sentive)
- Add theme to the main config in 'src/config.json'. Copy existing theme text in the config, for an example.
Built With
- React - The web framework used
- OpenLayers - Mapping framework
- GeoServer - Backend Map Server
Authors
- Al Proulx - Initial work - Al Proulx
License
This project is licensed under the MIT License - see the LICENSE.md file for details