Skip to content

Latest commit

 

History

History
142 lines (112 loc) · 9.64 KB

README.md

File metadata and controls

142 lines (112 loc) · 9.64 KB
Raw

About

Copernicus Browser is a search tool for satellite imagery, including Sentinel-1, 2, 3 and 5P. It was released as open-source to bring Earth Observation imagery closer to end users.

Some features:

  • Search by date, location, source, and cloud cover
  • Tweak imagery rendering parameters and settings on-the-fly and download beautiful visualizations of the data
  • Search full products and download raw data (individual files or entire products)
  • Add products to the workspace for further processing
  • Pin your results and make opacity or split image comparisons
  • Explore imagery in 3D
  • Create and share 2D/3D timelapses
  • Analyse the visualized data (measure, statistics, histogram)

The use of Copernicus Browser is free of charge. To unlock advanced features, you need to create a free account (here).

Copernicus Browser is part of the Copernicus Data Space Ecosystem, a new service for better access to and use of data from the EU's Copernicus satellites. You can find out more about the service here and in the Copernicus Browser user manual here you will find a detailed overview of the Browser's functionality.

Sentinel-2 Quarterly Mosaic for June - August in a True Color visualization (link)

Development

Contact us to get help about deploying the Browser on your infrastructure.

  • copy the file .env.example and rename the copied file to .env, fill out the needed values
  • use your instance ids in *_themes.js
  • Run npm install
  • Run npm start to run the application locally
  • Run npm run prettier to prettify js, json, css and scss files
  • Run npm run lint to lint js, json, css and scss files
  • Run npm run build to build the application sources
  • Run npm run translate to add strings to the translation files
  • Run npm run debug-translations to replace all translation strings with "XXXXXX"
  • Run npm run update-previews to create layer preview images
  • Run npm run update-metadata-cache to create getCapabilities and configuration cache

Environment variables in the .env file

The app relies on some values being provided as environment variables. The details are described in the collapsible section below.

Click to expand

Mandatory

  • REACT_APP_ROOT_URL: URL at which the app is (publicly) accessible

    • Needed for correctly setting URLs for assets and authentication.
    • http://localhost:3000/ for local development, the whole public url for deployments on web servers

  • REACT_APP_SH_SERVICES_URL: URL at which the Sentinel Hub services are accessible

    • https://sh.dataspace.copernicus.eu

Application supports usage with user login or anonymously (without having to log in). In case of anonymous usage, the instance ids in default_themes.js and education_themes.js need to be set. Contact us for support.

Environment variables needed for user login:

Environment variables needed for anonymous usage:

  • REACT_APP_CAPTCHA_SITE_KEY: Google Captcha site key for anonymous authentication (to enable usage without user login)
    • contact us for support
  • REACT_APP_ANON_AUTH_SERVICE_URL: URL for anonymous authentication (to enable usage without user login)
    • contact us for support

Optional

  • REACT_APP_EOB_BACKEND: Backend for saving user pins and timelapses
    • contact us for support
    • without it, users cannot save pins without downloading them or share timelapses
  • REACT_APP_MAPTILER_KEY: MapTiler key for accessing maps on MapTiler
    • create your key on MapTiler's website
    • without it, there will be no basemaps or overlays other than the default OSM basemap
  • REACT_APP_MAPTILER_MAP_ID_<name>
    • names and styles used in src/Map/Layers.js: BORDERS, ROADS, CONTOUR, WATER, VOYAGER, LIGHT, LABELS
    • create your maps on MapTiler's website
    • without it, there will be no basemaps or overlays other than the default OSM basemap
  • REACT_APP_GOOGLE_TOKEN: Google Maps API key for location search
  • REACT_APP_GOOGLE_MAP_KEY: Google Maps API key for Google satellite baselayer
  • REACT_APP_CDAS_ODATA_SEARCH_URL: Copernicus Dataspace Ecosystem URL for searching for products
  • REACT_APP_CDAS_ODATA_DOWNLOAD_URL: Copernicus Dataspace Ecosystem URL for downloading products
  • REACT_APP_REBRANDLY_API_KEY: URL shortener
    • create your account on Rebrandly's website
    • without it, users won't be able to share the short URL (the long URL still works)
  • REACT_APP_PLANET_API_KEY: Planet Labs API key for using their data
    • see Planet Labs website
    • without it, users won't be able to buy Planet data through this app or view it in the app

Optional, for maintenance

Multilanguage support

Thanks to the efforts of various people and institutions, you can use the Copernicus Browser in your native language. Since the Browser is under constant development, not all parts might be already translated in all languages.

Your language is missing or incomplete and you want to help with the translation? Contact us at translation_support@sinergise.com for more information.

Copernicus Browser, the evolution of EO Browser, shares many translations with its predecessor. A big thank you to everyone listed below (including those who didn't want to be publicly named) for their help in translating parts of the respective app.

Wall of fame:

Disclaimer

The translations in Copernicus Browser are a community effort and are largely provided on a voluntary basis. As the application contains several hundred translations per language, we cannot guarantee the accuracy of every single translation.