Skip to content

reearth/reearth-visualizer

Logo

GitHub stars issues license release

Website Β· Documentation Β· Issues


πŸ’‘ We are hiring full-time OSS comitters! https://eukarya.io/join

Features

Visualizer is a powerful tool for visualizing GIS data, offering a range of features to enhance your mapping experience:

  • Comprehensive WebGIS Support: Visualizer supports various common WebGIS data types, displaying them seamlessly on a digital map using Cesium as the rendering engine.
  • Interactive Geometry Drawing: Draw geometric shapes directly on the map for custom annotations and spatial analysis.
  • Conditional Layer Styling: Modify display styles for individual layers based on conditions, allowing for personalized data visualization.
  • Engaging Storytelling Feature: Create interactive, page-by-page narratives with your GIS data using the built-in storytelling feature.
  • Customizable Interface with Plugins: Use the plugin system to create custom solutions and tailor the interface of public projects to suit your needs.
  • Easy Project Publishing and Sharing: Publish your projects and share them effortlessly through distribution, embedding, or custom URLs.
  • Community Plugin Marketplace: Add your custom plugins to the marketplace and allow other users to integrate them into their projects.

Built with

React, TypeScript, Go, GraphQL, MongoDB, WebAssembly (plugin execution), OpenID Connect

Getting Started

Setup Server and Database

Make sure Docker is properly installed and running on your machine.

  1. From your cloned directory, navigate to the server folder and set up the database:

    cd server
    make run-db
  2. Create and configure the .env file in the server directory to use mock authentication.

    touch .env
    echo "REEARTH_MOCKAUTH=true" >> .env
  3. Start the backend server.

    make run-app
  4. Register a new mockuser.

    make mockuser

Setup Web

  1. Navigate to the web directory of your visualizer project and set up local .env file.

    cd web
    touch .env
  2. Add the following environment variables to the .env file:

    // .env
    REEARTH_WEB_API=http://localhost:8080/api
    REEARTH_WEB_PLUGINS=http://localhost:8080/plugins
    REEARTH_WEB_CESIUM_ION_ACCESS_TOKEN=your_cesium_ion_access_token_here
    REEARTH_WEB_AUTH_PROVIDER=mock
    

    Please follow this document to create your own Cesium Ion Access Token.

  3. Install dependencies and start the frontend server.

    yarn && yarn start

Done!

You should now be able to access the Re:Earth Visualizer locally at http://localhost:3000.

For more information, refer to the Documentation.

Environment

OS

Windows 10+ Apple macOS 10.12 (macOS Sierra)+ ChromeOS iOS 11+ Android 10+ Linux (with the desktop)
βœ… βœ… βœ… βœ… βœ… βœ…

Web Browsers

Edge
Edge
Firefox
Firefox
Chrome
Chrome
Safari
Safari
iOS Safari
iOS Safari
Chrome for Android
Chrome for Android
91+ 57+ 58+ 11+ last 2 versions last 2 versions

Contributing

See the contributing guide.

Contributers

Contributers

Made with contrib.rocks.

Contact

Re:Earth core committers: community@reearth.io

License

Distributed under the Apache-2.0 License. See LICENSE for more information.