Skip to content

Interactive interface for browsing global, full-resolution satellite imagery

4.0 KB
Raw Blame

Optional Features

Some of these features require CGI scripts to execute on your server. In order for them to function, make sure your server is configured to allow the execution of CGI files. Next, enable these features in your configuration file.

Layer Preview Images

By default during the build process we try to fetch images of layers from our Snapshots application to show as previews in the layer picker component. However, this will only work for layers that are present in NASA GIBS (Global Imagery Browse Services). If you are serving your own layers, you will likely wish to disable this feature by setting "previewSnapshots": false in config/default/common/features.json.

Natural Events

This feature provides natural events queried by Earth Observatory Natural Event Tracker (EONET) by default. To enable, edit config/default/common/features.json and set:

"naturalEvents": {
    "host": "[host_url_here]"
}

to disable, set: "naturalEvents": false

Data Download (Smart Handoffs)

This feature allows directing users to Earthdata Search to download the underlying data for layers. For more information see the Data Download (Smart Handoffs) docs. To enable, edit config/default/common/features.json and set "smartHandoffs": true.

Location Search

This feature uses the ArcGIS World Geocoding Service to find addresses based on input text, coordinates, and by clicking a spot on the map. To enable, edit config/default/common/features.json and set "locationSearch" object "url" to use the ArcGIS request URL used by the ArcGIS World Geocoding Service.

Skipping Layer Metadata

During the build process, Worldview fetches imagery layer metadata from the GIBS Layer Metadata API (see vismetadata.url in config/default/common/features.json) for every layer in the layer order. By default a fixed set of layers that do not exist in GIBS is skipped and won't be fetched. If you are serving your own layers, you can skip additional layers by adding their IDs to the vismetadata.skipLayers array:

"vismetadata": {
    "url": "https://gibs.earthdata.nasa.gov/layer-metadata/v1.0/",
    "skipLayers": ["your_internal_layer"]
}

Layers listed here are skipped in addition to the default set, so existing behavior is preserved.

URL Shortening

This feature uses bit.ly to shorten links. Follow these steps to enable it:

  • Edit config/default/common/features.json and set "urlShortening": true.
  • Get a login and API key from bit.ly.
  • Create build/options/bitly.json with the following contents (replacing your_login and your_key with the appropriate values);
{
  "login": "your_login",
  "key": "your_key"
}

Caution: Do not commit this file to a public repo, and make sure the build/options directory is not publicly accessible on your web server to protect the privacy of your API key.

Google Tag Manager

Worldview uses the analytics framework Google Tag Manager to collect user interface interaction metrics. To use this feature, obtain a Google Tag Manager ID formatted as "GTM-XXXXXX", and add the ID as environment variable GTM_ID that can be accessed during the build process to inject your ID into the necessary code. This feature is turned on by default:

"googleTagManager": true

to disable this feature, set: "googleTagManager": false

Charting Mode

This feature queries GIBS ImageStat to collect data across a time range for a selected layer, then creates a visualization of that data via a line chart. To enable, edit config/default/common/features.json and set "charting" to true, which will populate the 'Start Charting' button on the bottom of the layer list sidebar (enabled by default).