Skip to content

reearth/reearth-visualizer

Folders and files

NameName
Last commit message
Last commit date
Jan 31, 2025
Aug 27, 2024
Nov 26, 2024
Jan 30, 2025
Jan 31, 2025
Jul 24, 2024
Apr 16, 2024
Jan 20, 2025
Jun 23, 2021
May 29, 2024
May 28, 2021
Nov 28, 2024
May 18, 2023
Apr 17, 2023
Jul 17, 2024
Jan 28, 2025
Jan 30, 2025
Jan 27, 2025

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: [email protected]

License

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