# About

EarthCache, powered by SkyWatch, is the easiest way for ArcGIS users to access satellite imagery from the world's leading data providers.

<figure><img src="/files/zKHWAmMUchH3lg2krwGK" alt=""><figcaption></figcaption></figure>

With the **EarthCache Add-In for ArcGIS Pro**, EarthCache users can unlock the power of satellite imagery, directly in ArcGIS. The add-in enables you to:

* Bring multiple data types and sources, including Planet and Airbus datasets, into your ArcGIS workflows.
* Access the robust EarthCache archive, or task new images, without leaving ArcGIS.
* Access free, low-resolution imagery from leading open sources.
* Minimize costs with SkyWatch's transparent, pay-as-you-use pricing.
* Leverage all the capabilities of ArcGIS Pro, including imagery analysis, comparison, and visualizations.
* Using your Esri Suite, publish directly in ArcGIS Online or easily save your data where you need it for your analytical and sharing needs

## How to get started

1. Download and install the latest version (1.18) of EarthCache Add-In for ArcGIS 3.0 and above, from [<mark style="color:blue;">here</mark>](https://skywatch-public-esri.s3.us-west-2.amazonaws.com/arcgis-pro-addin/EarthCache1.18Pro3.x.esriAddinX).&#x20;
   * To download the EarthCache Add-In for ArcGIS 2.9, see [<mark style="color:blue;">here</mark>](https://skywatch-public-esri.s3.us-west-2.amazonaws.com/arcgis-pro-addin/EarthCache1.18Pro2.x.esriAddinX)
2. Request an EarthCache account through [<mark style="color:blue;">this form</mark>](https://skywatch.com/earthcache/get-started-arcgis/).
3. Activate your account through the link in your email and create password.
4. Use your new [<mark style="color:blue;">EarthCache</mark>](https://console.earthcache.com/dashboard/location)\* login to sign in to your EarthCache for ArcGIS Add-In.
   * EarthCache Add-In for ArcGIS Pro 2.9 requires downloading Webview2 separately. See [<mark style="color:blue;">Installation</mark> ](https://skywatch-arcgis.geomarvel.cloud/pages/hjGsSiVhVVc7yCCCYdJH#download-webview2-if-using-add-in-for-arcgis-pro-2.9)for instructions on how to do this.
5. Start searching for and ordering data!

\*If you need to access or manage your payment information, you can do so through [<mark style="color:blue;">EarthCache Console</mark>](https://console.earthcache.com/dashboard/location) and manage your payment information through the "Account" page.


# Setup


# Account Setup

Here's how to set up an account with SkyWatch and start using the EarthCache ArcGIS Pro AddIn

To fully utilize the power of the EarthCache ArcGIS Pro Add-In, you must register for a SkyWatch account. Here's how:

1. Visit [<mark style="color:blue;">https://skywatch.com/earthcache/get-started-arcgis/</mark>](https://skywatch.com/earthcache/get-started-arcgis/)

<figure><img src="/files/Mn4urba7jcNXdGjrSqPS" alt=""><figcaption></figcaption></figure>

2. Fill out the Request form and Submit to request access from SkyWatch

<figure><img src="/files/qoO0j6r8haqxoFHQF8zn" alt=""><figcaption></figcaption></figure>

3. Once you've requested access, you will receive an email prompting your account activation. You will click the link, create your password, and your account will be created. You can now return to the EarthCache Add-In and login.

For Technical Support, contact [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)


# System Requirements

System Requirements for EarthCache AddIn for ArcGIS Pro

**The EarthCache ArcGIS Pro Add-In** **is compatible with ArcGIS Pro 3.0+ and ArcGIS Pro 2.9. Both versions use different download files. See** [<mark style="color:blue;">**How to Get Started**</mark>](/#how-to-get-started) **for more information.**

Requirements to use the Add-In for ArcGIS Pro 2.9

* To use the EarthCache Add-In for the 2.9 version of ArcGIS Pro, an additional download of WebView2 is required. See [<mark style="color:blue;">Installation</mark> ](https://skywatch-arcgis.geomarvel.cloud/setup/pages/hjGsSiVhVVc7yCCCYdJH#download-webview2-if-using-add-in-for-arcgis-pro-2.9)for more details.

Storage requirements:

* Imagery downloads necessitate a considerable allocation of storage space. It is essential to ensure that an adequate amount of disk space is available on your computer prior to initiating the imagery download process through the Add-In.

Network requirements:

* Downloads and requests to the SkyWatch API can be time and resource-consuming. For optimal performance, please make sure that your internet connection meets minimum speed requirements for data downloads.

### Firewall exceptions

If your organization's firewall restricts URL requests from ArcGIS Pro, please contact your IT department to whitelist the following URLs:

* [<mark style="color:blue;">https://skywatch.com/</mark>](https://skywatch.com/)
* [<mark style="color:blue;">https://skywatch.auth0.com/</mark>](https://skywatch.auth0.com/)
* [<mark style="color:blue;">https://api.skywatch.co/</mark>](https://api.skywatch.co/)
* [<mark style="color:blue;">https://api.dashboard.skywatch.co/</mark>](https://api.dashboard.skywatch.co/)
* [<mark style="color:blue;">https://support.skywatch.com/</mark>](https://support.skywatch.com/)
* [<mark style="color:blue;">https://academy.skywatch.com/</mark>](https://academy.skywatch.com/)

\
For Technical Support, contact [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)


# Download

To download the EarthCache ArcGIS Pro Add-In,&#x20;

1. Visit the product page at ArcGIS Marketplace here.

<https://www.esri.com/en-us/arcgis-marketplace/listing/products/720633ae9a1640989ad322f8ca1c654d>

<figure><img src="/files/a2EKcs3WF2TyyGFGClxX" alt=""><figcaption></figcaption></figure>

2. Proceed through prompts on the screen to download Add-In from ArcGIS Online

<figure><img src="/files/nYnxgRKqvJ4RPe6qdbBI" alt=""><figcaption></figcaption></figure>

For Technical Support, contact [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)


# Installation

Here's how to install the Add-In after downloading it from ArcGIS Marketplace

1. Browse to the folder location of the EarthCache Add-in file (\*.esriAddInX) that you downloaded on your computer.
2. Double-click the file to open the Esri ArcGIS Add-In Installation Utility window.

   <figure><img src="/files/Dj8NG7rbsOnoOa79S1aM" alt=""><figcaption></figcaption></figure>
3. To continue, click Install Add-In. The Add-In is copied to the default location and installed. A copy of the file remains in the location where you browsed to it.
4. If ArcGIS Pro is open, exit and restart the application. The Add-In is now available for use.

### Download WebView2 if using Add-In for ArcGIS Pro 2.9

If the Add-In is being installed for ArcGIS Pro 2.9, a download of WebView2 is required. You will see a message when logging in for the first time to download WebView2. Visit the URL to start the download, or click [here ](https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/03e33965-9ac7-458c-b6bc-c48177736a31/MicrosoftEdgeWebview2Setup.exe)to download WebView2. Note: Visiting this URL will immediately start download in your browser. If you're unable to download WebView2, see [instructions ](https://skywatch-arcgis.geomarvel.cloud/setup/pages/86SE0qJTMn97CXmALeiI#arcgis-pro-2.9-note)on how to get around this requirement.

For Technical Support, contact [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)


# Add Payment Method

Sign in to your EarthCache account to see your account information, add payment, and view your imagery orders

To log in to your EarthCache Console, click "LOGIN" at the top when you visit [<mark style="color:blue;">https://console.earthcache.com/</mark>](https://console.earthcache.com/)

<figure><img src="/files/5gn5qVTVGoRZ26LRjOJg" alt=""><figcaption></figcaption></figure>

Use your SkyWatch credentials to log in

<figure><img src="/files/E84DbBzuw9DkfbCq4O3k" alt=""><figcaption></figcaption></figure>

Under Account, you can see your account settings and add a form of payment&#x20;

<figure><img src="/files/132Ku8NpjPsYQzCEXLfs" alt=""><figcaption></figcaption></figure>

Visit Dashboard to see your current orders and imagery pipelines

<figure><img src="/files/yVFRF0FX6kkpdO5Wn5xa" alt=""><figcaption></figcaption></figure>

For Technical Support, contact [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)


# Manual


# Sign in to EarthCache ArcGIS Pro Add-In

To use EarthCache Pro Add-In, you must sign in using your credentials

To use EarthCache Pro Add-In, you must sign in using your credentials. If you do not have an account, return to the [<mark style="color:blue;">Account Setup</mark>](/setup/account-setup) page.

If you forgot your password, return to [<mark style="color:blue;">console.earthcache.com</mark>](http://console.earthcache.com/) and select "Forgot Password". You should then receive an email with a link to change your password.

\
If you simply wish to change your password, login to your account at [<mark style="color:blue;">console.earthcache.com</mark>](http://console.earthcache.com/) and on the accounts page you can request to change your password.

To sign in to EarthCache in ArcGIS Pro, click on the EarthCache tab located at the top of ArcGIS Pro. Click on "Login".

<figure><img src="/files/0OqiBMQ5BttRYJZbEHcf" alt=""><figcaption></figcaption></figure>

Click on Login and you'll see a prompt to use your Skywatch credentials. Click "Continue" after you're done.

<figure><img src="/files/6ubSwbZglQp5Tg770xGR" alt=""><figcaption></figcaption></figure>

### ArcGIS Pro 2.9 Note:&#x20;

1. If you're signing into the Add-In on ArcGIS Pro 2.9, you may get a message asking to download WebView2. WebView2 download is required to use the Add-In. Follow the URL to download WebView2.
2. If you're unable to download the WebView2 file, we recommend adding the API Key from your EarthCache Account on the browser directly to the Add-In. Here's how:

   * Visit [<mark style="color:blue;">EarthCache Console</mark>](https://console.earthcache.com/account) and copy "Your API Key".
   * Switch back to ArcGIS Pro 2.9. In the top ribbon, click on "Project".&#x20;
   * In the menu that appears, click on "Options". Scroll down on the left to see "EarthCache Settings".
   * Paste the API Key you copied from the browser to the field under "API Key" as shown in the image below. Click OK, and you're signed in!

   <figure><img src="/files/S91o9C6Mua1U29AHahvO" alt=""><figcaption></figcaption></figure>


# View EarthCache Settings in ArcGIS Pro

Once you've logged in successfully, you can visit Options under the Project Menu

<figure><img src="/files/WPKBYXpkuG4pxqnPJbLJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Z8JTgIhZ2klZ1zuswZvE" alt=""><figcaption></figcaption></figure>

Select EarthCache Settings from the left menu

<figure><img src="/files/ypSnqGUYkgQtwVBddLFJ" alt=""><figcaption></figcaption></figure>

From this Settings view, you can set the Download Folder for your imagery files, and also see your API Key. The default location for Download is *C:/users/\<youruser>/Downloads/*


# Search Archive

Search the EarthCache archive for already-collected imagery that fits your needs

Data that has already been captured and stored by one of SkyWatch's data partners is called **archive data**. Archive data allows you to find information about the past state of your area of interest and monitor change over time.&#x20;

Click on the EarthCache Tab to open the Add-In ribbon. Then, click on "Search Archive". The search pane will open in your Project window, to the left of your Map.

<figure><img src="/files/F5nM66UjNpGIOE0D8RqC" alt=""><figcaption></figcaption></figure>

## Explanation of Fields

### AOI Layer

:warning: *Before drawing your own AOI, it is highly recommended that you save and close out any editing sessions you are currently performing on vector data, as this tool will automatically save any open edit sessions*

Please make sure that your AOI polygon respects the required conditions given [<mark style="color:blue;">here</mark>](/manual/aoi-minimum-requirements).

To select a polygon layer from your Table of Contents as your input Area of Interest (AOI), click the dropdown under "Select AOI Layer". This dropdown will be automatically updated with any layer you add or remove from the Table of Contents.&#x20;

<figure><img src="/files/u1PZVNkjEp1yKCm9jJtg" alt=""><figcaption></figcaption></figure>

If you want to create a new Area of Interest that's not in Table of Contents, you can draw one yourself on the map, by clicking the Pencil icon next to "Select AOI Layer"

<figure><img src="/files/vYCHN7G5qIAxsu7P9nkx" alt=""><figcaption></figcaption></figure>

This will open Draw tools at the bottom of your active Map window

<figure><img src="/files/szCXr2EvhBkJB5Ug0sed" alt=""><figcaption></figcaption></figure>

Click on the Map to draw your Area of Interest.

<figure><img src="/files/bw0CcfGnjBqaDJYcSjN1" alt=""><figcaption></figcaption></figure>

Once complete, double click on the map to finish drawing. The layer will be automatically added to the dropdown as EarthCache User AOI

<figure><img src="/files/cS2NQTyF0tpNUFM4M1qA" alt=""><figcaption></figcaption></figure>

### Resolution

Select the desired resolution for your search. Please make sure that your AOI area respects the [<mark style="color:blue;">requirements</mark> ](/manual/aoi-minimum-requirements)of the resolution that you choose.

### Minimum Coverage

It is generally recommended to use a value of 1% to return all possible results. If you are only interested in imagery that covers the entire AOI, then setting it to 85% or higher is recommended. The default value for Minimum Coverage is 80%.&#x20;

Once ready, click "Run". You will see a new pane open at the bottom called "EarthCache Search Results". Scroll to see all results categorized by Search ran, resolution and sensor/timestamp. Click "Expand All" button at top to expand all results, and click "Collapse All" to collapse them.&#x20;

<figure><img src="/files/OzjgYfw7ja1CS8ljfBRy" alt=""><figcaption></figcaption></figure>

You can filter your results by scrolling to the top and clicking on "Filter Results". You can filter by keyword in name, sensor, resolution range, maximum cloud cover (%), or minimum AOI coverage. Start typing into these fields and the search results will filter based on filter values.

<figure><img src="/files/kBxqao0StZxt2U2173jw" alt=""><figcaption></figcaption></figure>

Each result contains information about cost, area coverage, cloud cover, and resolution. If you want to see the imagery previewed on the map as a low-resolution .png, click "Preview in Map". The image will be added to the Table of Contents and appear on Map. Note that this preview image may take a moment to show up.

<figure><img src="/files/4xF7MtZJCGvwc8IB6crx" alt=""><figcaption></figcaption></figure>

Scroll through the results and check the boxes for ones you want to add to this order. Then, scroll to the bottom and add a name to the order to easily identify it in your Order Dashboard later.&#x20;

<figure><img src="/files/zEbg9VVmEPhw8VEB1RlP" alt=""><figcaption></figcaption></figure>

You can also expand the "Add Tags" section to add text labels and values to this order. Doing this can make searching for results in the Order dashboard easier.

<figure><img src="/files/nDf2vXYPRbPh409gT0kt" alt=""><figcaption></figcaption></figure>

Once you're ready to place your order, click on the "Order" button at the bottom. You will be prompted to a popup that asks to confirm the total price of creating the pipeline. Click "Yes" to proceed.

<figure><img src="/files/qMdgDcWQ01xvm0Hrn839" alt=""><figcaption></figcaption></figure>

Once the order is placed, the EarthCache Order Dashboard opens up on the left.

**Tip:** Depending on whether data was captured on a specific day, archive data may or may not be available over your area of interest. If data is unavailable, try expanding your search parameters to other resolutions, a more tolerant cloud coverage, or allow for a wider date range


# Order Imagery

In addition to searching for archived imagery, you can order new imagery for an Area of Interest

From the EarthCache tab in ArcGIS Pro, click on "Order Imagery". The "Order EarthCache Imagery" pane will open to the left of the active Map window.

<figure><img src="/files/OvdcaD0EjI5O6zZBnqdT" alt=""><figcaption></figcaption></figure>

## Explanation of Fields

### AOI Layer

:warning: *Before ordering new imagery and drawing your own AOI, it is highly recommended that you save and close out any editing sessions you are currently performing on vector data, as this tool will automatically save any open edit sessions*

Please make sure that your AOI polygon respects the required conditions given [<mark style="color:blue;">here</mark>](/manual/aoi-minimum-requirements).

To select a polygon layer from your Table of Contents as your input Area of Interest (AOI), click the dropdown under "Select AOI Layer". This dropdown will be automatically updated with any layer you add or remove from the Table of Contents.&#x20;

<figure><img src="/files/u1PZVNkjEp1yKCm9jJtg" alt=""><figcaption></figcaption></figure>

If you want to create a new Area of Interest that's not in Table of Contents, you can draw one yourself on the map, by clicking the Pencil icon next to "Select AOI Layer"

<figure><img src="/files/vYCHN7G5qIAxsu7P9nkx" alt=""><figcaption></figcaption></figure>

This will open Draw tools at the bottom of your active Map window

<figure><img src="/files/dhXKYOMChKrwQ0xNtJsI" alt=""><figcaption></figcaption></figure>

Click on the Map to draw your Area of Interest.

<figure><img src="/files/lYixLlmWa9fOO0cVM45Q" alt=""><figcaption></figcaption></figure>

Once complete, double click on the map to finish drawing. The layer will be automatically added to the dropdown as "EarthCache User AOI"

<figure><img src="/files/cS2NQTyF0tpNUFM4M1qA" alt=""><figcaption></figcaption></figure>

### Output Layer Type

Next, select your desired output's optical bands. For a detailed description of the outputs, see here: [<mark style="color:blue;">https://support.skywatch.com/hc/en-us/articles/7297565063067-Available-Outputs</mark>](https://support.skywatch.com/hc/en-us/articles/7297565063067-Available-Outputs)

<figure><img src="/files/t8JWGF1hoVSNUKsP48bC" alt=""><figcaption></figcaption></figure>

### Pipeline Name

Optionally, you can give your pipeline a name by entering text in the Pipeline Name field. This will make it easier to identify and recognize from your Order Dashboard.

<figure><img src="/files/goCdeZMKroJ5dy1FbyB8" alt=""><figcaption></figcaption></figure>

### Start and End Date

Choose a start and end date for the pipeline you're requesting. The end date can be a future date.

<figure><img src="/files/H2liUF6XPX9AZPo17YLq" alt=""><figcaption></figcaption></figure>

### Interval Mode

Single:

* The search range will be the entirety of the date range. The maximum is 999 days.

Multiple:

* This breaks the range into multiple orders based on the days of collection. This is common for change detection and monitoring purposes. Here are some examples.
* Multiple - 30 days, June 1 - September 30
  * 4 captures - 30 days, 30 days, 30 days, 2 days
  * June 1 - June 30, July 1 - July 30, July 31 - August 29, August 30 - September 29th, September 29th - September 30th. Since 2 of those months are 31 days, there is a short interval added to the end.
* Multiple - 31 days, June 1 - September 30
  * 3 captures - (31 days, 31 days, 30 days)
  * June 1 - July 1, July 2 - August 1, August 2 - September 3, September 3 - September 30

### Resolution

Select the desired resolution for your pipeline. Please make sure that your AOI area respects the [<mark style="color:blue;">requirements</mark> ](/manual/aoi-minimum-requirements)of the resolution that you choose. For more info, please see [<mark style="color:blue;">here</mark>](https://support.skywatch.com/hc/en-us/articles/13372177880987-Maximum-and-Minimum-AOI-Sizes). The table below shows a summary of AOI size requirements.

<figure><img src="/files/Ull0v3Eyf9dfXTMPnkK2" alt=""><figcaption></figcaption></figure>

### Mosaic On/Off

It is recommended to turn mosaicking on for tasking. Mosaicking will stitch together any products which provide partial coverage of the AOI. If this is turned off and 2 images are collected which each cover 50% (i.e. do not reach your coverage setting) no imagery will be returned.&#x20;

### Tasking Allowed

Tasking enables the end-user to request that a satellite collect imagery of the AOI during a certain time interval. Tasking data has a higher chance of data being collected, therefore is offered at a premium rate and includes minimum order sizes. This means you will be charged as if your area of interest was 25 km² (or larger if your area of interest is larger than 25 km²). Collection is not guaranteed but probable. Furthermore, tasking is enabled only for High and Very High Resolutions.

### Minimum Coverage (%)

This coverage value is for usable pixels. This means that it considers total overlap, as well as cloud percentage. If it were 5% clouds and 90% overlap, a 90% coverage setting would return no results. This should not be set 90% or higher as it greatly reduces your chances of getting imagery. You will be charged for the entire area of interest.

This value is default-set to 80%.

You can also expand the "Add Tags" section to add text labels and values to this order. Doing this can make searching for results in the Order dashboard easier.

Information about pricing (given in USD):

When Tasking is allowed, the following prices apply.

* High Resolution: $12/km²
* Very High Resolution: $30/km²

Furthermore, if you have multiple intervals set, this will reflect in the price. If there are 3 features being submitted, each one is $500 dollars, then the order will show 3 pipelines and $1500. If in addition there are 2 intervals, the order total will show 3 pipelines and $4500.

When ready to submit your order, click "Submit". You will see the following prompt. Click "Yes" to continue.

<figure><img src="/files/vmPCrCbCcolVzxOW1mr8" alt=""><figcaption></figcaption></figure>

The EarthCache Order Dashboard will open to the left of the Active Map, where you can see the pipeline you just created.


# AOI Minimum Requirements

Your Area of Interest polygon must meet certain requirements before it can be used with Search Imagery or Order Imagery

All input Areas of Interest (AOI) must the following criteria:&#x20;

1. Feature must be a polygon in a shapefile or feature class. Features in other file formats will not be accepted!
2. Feature must contain less than 500 vertices
3. Must be single part features
4. Feature cannot contain holes/donuts
5. Must be valid geometries - contain no self-intersecting features

The size requirements for your input AOI when [<mark style="color:blue;">Searching the Archive</mark>](/manual/search-archive) and [Ordering Imagery](/manual/order-imagery) are as follows:

* Low Resolution: 1km² - 10,000km²
* Medium Resolution: 1km² - 500km²
* High Resolution: 1km² - 500km²
* Very High Resolution: 1km² - 150km²

When creating a new pipeline by [<mark style="color:blue;">Ordering Imagery</mark>](/manual/order-imagery), if Tasking is turned on, the following requirements and conditions apply:

* High Resolution: 25km² - 50km²
* Very High Resolution: 25km² - 50km²
* If Tasking is turned on, areas less than 25km² can be submitted, but will be charged at 25km². It is recommended to buffer to 25km² to maximize value.


# Order Dashboard

Easily view and edit your pipelines and orders on the Order Dashboard

To access the Order Dashboard, click on the "My Orders" button in the EarthCache ribbon

<figure><img src="/files/5vo26ezIJSJSnDScoHVZ" alt=""><figcaption></figcaption></figure>

The Order Dashboard will open to the left of the active Map.

<figure><img src="/files/L2O1XmSHFCzbwLCHMEo8" alt="" width="274"><figcaption></figcaption></figure>

### Filter Pipelines in Order Dashboard

You can filter the pipelines that appear in your Order Dashboard by clicking the dropdown at the top of Dashboard and selecting the category to filter by, and then typing in a keyword to start the filter. You can filter by Name, Pipeline ID, Status and Tags.

<figure><img src="/files/pIPhf2DH81ofEHzLah6g" alt=""><figcaption></figcaption></figure>

Each row in the Dashboard represents an imagery pipeline in your account, created from Search or Order. Click on a row and you can see the results for the pipeline.

<figure><img src="/files/FEbmvr1O7PRgDkUCVsYJ" alt=""><figcaption></figcaption></figure>

The results for a pipeline are categorized according to interval dates, status, created date, number of results, lowest and highest resolution. Click on a result and the row expands to show details for the result.&#x20;

<figure><img src="/files/k5UQwlOoW4EBeffQMGqD" alt=""><figcaption></figcaption></figure>

You can click on "Quick View" to download the preview image file and view it in your active Map.

Click on "Analytic Data" to download the imagery .tif file and view it in your active Map.

Click on "Open in Explorer" to download the metadata JSON file and open the location in Windows Explorer.

Once files for the result finish downloading, a message will appear at the top-right of your ArcGIS Pro window. A green box will appear around the download icon for all downloaded files from this session.

&#x20;

Each imagery pipeline in your Dashboard is categorized according to status, name, created date, ID, interval, start and end dates and tags. Click on the column name headers to sort the table with the selected field.

### Controls for Pipelines

![](/files/oLFevgYKEdn4o2pNl9By) **Refresh Dashboard -** Click the Refresh icon to update your Dashboard with the latest orders and their statuses.

Each imagery pipeline has control buttons for actions you can perform to the pipeline to make it easier to visualize or organize

<figure><img src="/files/Wgoi2a9Ad4wIHmu4wjPJ" alt=""><figcaption></figcaption></figure>

![](/files/taKSzHy2cq3gGXz0ubQa)**Trash -** Delete this pipeline from your Dashboard. You'll be asked to confirm before deleting.

<figure><img src="/files/x5QQV7g1m0OJ0I8MGpFY" alt=""><figcaption></figcaption></figure>

Warning: Once deleted, this pipeline cannot be retrieved again

![](/files/UdLapsQ1A0rz1IWUfQjK)**Zoom to AOI -** Add the AOI for this pipeline to the map and zoom to it

![](/files/x9mKYexNXNE5iZWYiX2L)**Add AOI to map as a feature layer -** Add the AOI for this pipeline to the map

Both![](/files/UdLapsQ1A0rz1IWUfQjK) and![](/files/RFBvx7BsrpC5HdLCyDAJ)adds the AOI as a feature layer to the Table of Contents under *EarthCache Layers/EarthCache Vectors*

### Bulk Download

Instead of selecting results one by one to download, you can click on checkboxes next to each row and add it to Bulk Download.

<figure><img src="/files/A987WYtURImWkqu1P8Bi" alt=""><figcaption></figcaption></figure>

Click the "Bulk Download" button at the bottom-left corner to start, and you'll be prompted with a similar message as follows:

<figure><img src="/files/C2k4FEUo60eFVp1k7kWI" alt=""><figcaption></figcaption></figure>

Click "Yes" to continue. You will see a Bulk Download window open and download the files. Do not close this window, as it will terminate all pending downloads.

<figure><img src="/files/11NGUOYfO5ybsQTqmY2u" alt=""><figcaption></figcaption></figure>

Layers downloaded using Bulk Download will not be added on-the-fly to Table of Contents in ArcGIS Pro. To add this data yourself, visit your EarthCache download directory and add the data to map. To view or edit the location of your EarthCache download directory, visit [<mark style="color:blue;">here</mark>](/manual/view-earthcache-settings-in-arcgis-pro).

### Upload Imagery to Cloud

If you've [configured Cloud Storage](/manual/configure-cloud-storage) in EarthCache, you will see a button in the Quick View, Analytic Data and Metadata columns to upload your data to your selected S3 bucket or Azure Blob Storage container. Click this button to start the upload process. You will receive a message in ArcGIS Pro upon completion of this task. You should now see the data in your selected cloud storage account.

<figure><img src="/files/AuarKv1afkn7JerNd68E" alt=""><figcaption></figcaption></figure>

###


# Configure Cloud Storage

Upload pipeline data directly from your Order Dashboard to an AWS S3 Bucket or Azure Blob storage container

Click on "Configure Cloud Storage" from the EarthCache tab.

<figure><img src="/files/UYl5lrhUHwE5qWi7TQH8" alt=""><figcaption></figcaption></figure>

This will open the Cloud Storage Configuration window where you can input your AWS S3 bucket settings or Azure Blob storage container settings. You can choose to input as configurations for as many S3 buckets and Blob containers as you want.

<figure><img src="/files/iQt0YZZsUnjLjvutE56R" alt=""><figcaption></figcaption></figure>

### S3 Bucket configuration

#### Note before beginning :warning:

EarthCache data upload to AWS S3 requires an existing configured bucket and access to an IAM role capable of writing to the bucket. The following hints are guidelines, SkyWatch is not responsible for security misconfigurations. You are responsible for all charges related to these operations.

#### Access Key and Secret Key

The Access Key and Secret Key for an IAM role can be found on the [IAM Console](https://console.aws.amazon.com/iam/) by selecting 1) Users 2) \[IAM user name] 3) Security Credentials 4) Create access key -or- Show. Note: The IAM role requires a minimum of bucket write permissions. Please see the [Identity and Access Management In Amazon S3 Documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) for more information.

#### S3 Region:

The region where your AWS S3 Bucket is established. This is the region used for data upload by the EarthCache add-in. For additional information see the [AWS S3 Service endpoints documentation](https://docs.aws.amazon.com/general/latest/gr/s3.html).

#### Bucket Name:

The bucket where data will be uploaded. The bucket must be [created in advance](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) - the EarthCache add-in will not create the bucket. The bucket name must be [globally unique and meet other name requirements](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).

Enter an easily identifiable name for this configuration in the Configuration Alias field. This is the name given to this configuration that you can select from the dropdown on top.

### AWS Blob Storage Container configuration

<figure><img src="/files/I3gmsrAX84HK67shebXh" alt=""><figcaption></figcaption></figure>

#### Note before beginning :warning:

EarthCache data upload to Azure Blob Storage requires an existing configured container and access to a Storage Account capable of writing to the container. The following hints are guidelines, SkyWatch is not responsible for security misconfigurations. You are responsible for all charges related to these operations.

#### Azure Storage Connection String

A [Storage Account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal#create-a-storage-account-1) is used to link credentials to Azure Blob Storage containers, and the Azure Storage Connection String defines the account credentials and protocols. To create a new storage account and retrieve the Azure Storage Connection String, log into the Azure portal then select 1) Storage accounts 2) Create 3) \[consult with your organization on appropriate account settings] 4) Under the Security + networking heading, select Access Keys 5) Select the correct Storage account name 6) Show and Copy one of the Connection String entries. Please see the [Manage Storage Account Access Keys Documentation](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage) for more information.

#### Container Name:

The container where data will be uploaded. The container must be [created in advance](https://learn.microsoft.com/en-us/azure/storage/blobs/blob-containers-portal) - the EarthCache add-in will not create the container. The container name must be [globally unique and meet other name requirements](https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata).

Enter an easily identifiable name for this configuration in the Configuration Alias field. This is the name given to this configuration that you can select from the dropdown on top.

Once you've configured your cloud storage settings for EarthCache, you can visit the Order Dashboard to upload your pipeline data to your S3 or Azure Storage container.


# Publishing Data

## <mark style="background-color:blue;">ArcGIS Image Server</mark>

<https://enterprise.arcgis.com/en/server/latest/publish-services/windows/publishing-image-services-from-arcgis-pro.htm>

### What can be published as an image service?

You can publish the following as an image service:

* Raster dataset
* Mosaic dataset

### Options for publishing depending on your setup

You have the following options for publishing image services depending on your software:

* I have ArcGIS GIS Server only.\
  Use the Catalog pane to publish the service. You can only publish raster datasets.
* I have ArcGIS GIS Server and ArcGIS Image Server.\
  You can use the Catalog pane to publish the service. You can publish raster datasets and mosaic datasets.\
  License:\
  ArcGIS Image Server is also required when publishing a map document containing a mosaic dataset or raster layer using the Mosaic function in its function chain. Without ArcGIS Image Server, the services created from these documents will not contain the mosaic dataset or layer.

### Publish an image service

In ArcGIS Pro, you can share selected raster dataset as web imagery layers to ArcGIS Enterprise. The default configuration allows you to view the dataset and its associated metadata. The privilege to publish server-based layers is required to share a web imagery layer. See [Web imagery layer](https://pro.arcgis.com/en/pro-app/3.1/help/data/imagery/web-image-layer.htm) for instructions on publishing imagery layer that references registered data.

## <mark style="background-color:blue;">ArcGIS Online for Image</mark>

<https://doc.arcgis.com/en/arcgis-online/manage-data/publish-imagery-layers.htm>

<figure><img src="/files/DdDyceKl3wBYWHcerRY0" alt=""><figcaption></figcaption></figure>

Hosted imagery layers can be used to manage, share, and analyze raster and imagery data in your organization. You can perform analysis using tools and raster functions with hosted imagery layers in Map Viewer or Map Viewer Classic. You can also manage large collections of imagery, and include imagery layers in hosted apps and maps. Hosting an imagery layer on ArcGIS Online is one way to share data with an internet audience if your own ArcGIS Server site cannot be made public. Maps, apps, and desktop map viewers in your organization can access your services from anywhere on the internet if you choose to allow it.

Publish a hosted tiled or dynamic imagery layer in ArcGIS Online by using the Create imagery layers window that guides you through creating an imagery layer. You can publish one or multiple imagery layers for supported data types.

To create hosted imagery layers, you must have [privileges](https://doc.arcgis.com/en/arcgis-online/administer/roles.htm) to publish hosted imagery layers and create content.

**Note:**

Hosted imagery layers are different from [raster tile layers](https://doc.arcgis.com/en/arcgis-online/reference/tile-layers.htm). Raster tile layers support visualization of imagery and raster data, but they do not support analysis. Hosted imagery layers allow access to the imagery or raster data, including the pixel or cell values across multiple bands, and multidimensional data.

### Create an imagery layer

<figure><img src="/files/z9XwhnaIqfSlQsMncdVL" alt=""><figcaption></figcaption></figure>

To create web maps with raster and imagery data, and to share this data with internal and external users, publish your data as hosted imagery layers.

You can publish data as tiled or dynamic imagery layers, with one or multiple imagery layers, or you can mosaic several images as one imagery layer. You can also publish multiple images as an image collection, which allows you to query the resulting hosted imagery layer for the properties of individual images.

Both tiled and dynamic imagery layers support access to imagery pixel data and metadata such as raster attribute tables, statistics, and histograms. With tiled imagery layers, groups of pixels are processed as static tiles, and processing occurs on the client machine. With dynamic imagery layers, you can also use raster function templates as a custom renderer to perform analysis on the fly. All processing is done on the server side.

If you publish a hosted tiled imagery layer from JPEG source imagery, the WMTS capability is automatically enabled on the hosted tiled imagery layer.

## <mark style="background-color:blue;">Publish hosted tile layers from files</mark>

<https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm>

Tile layers published to and hosted on ArcGIS Online support fast visualization of large datasets using a collection of predrawn map images or tiles. Hosted tiles provide geographic context for your operational layers. For example, you can include tiles of streets in your neighborhood to provide a visual reference for the street signs in your feature layer.

Tile layers hosted on ArcGIS Online are useful when you need to expose a map on the web for visualization, but you do not have your own ArcGIS Server. They also allow you to share certain maps with an internet audience if your own ArcGIS Server cannot be made public. [WMTS is available](https://doc.arcgis.com/en/arcgis-online/manage-data/hosted-web-layers.htm#ESRI_SECTION3_3EC8661CA3394B51A99822B0E09B839B) for tile layers hosted on ArcGIS Online that are shared with the public.

You can publish a tile layer [from an existing hosted feature layer](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles-from-features.htm), or use any of the following methods to create a file in ArcGIS Pro or ArcMap, and use that file to publish a hosted tile layer in ArcGIS Online:

<figure><img src="/files/qwGy7x3O4rOoXHl2oKqO" alt=""><figcaption></figcaption></figure>

* [Define a map in ArcGIS Pro](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm#ESRI_SECTION1_86DEFEF756A047B78EFE3DD4788A0AE7) and allow ArcGIS Online to create the tiles.
* [Build a tile package in ArcGIS Pro](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm#ESRI_SECTION1_9DDC0AFDD2AD4AF59CD36A29721AB67A), upload and publish to your ArcGIS Online organization.
* [Define a map in ArcMap and publish as a tile layer](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm#ESRI_SECTION1_A2E4F9EB87454D84B66788D7D4C027EC) to ArcGIS Online.
* [Build and share a tile package in ArcMap](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm#GUID-C467C9D7-443D-48D6-90AB-8204E3B9FD83) and publish it in ArcGIS Online.
* [Define a service definition file in ArcMap or ArcGIS Pro](https://doc.arcgis.com/en/arcgis-online/manage-data/publish-tiles.htm#ESRI_SECTION1_08DDA29C1F264B398BB618CFFB550A08), upload it, and allow ArcGIS Online to create the tiles.

**Tip:**

See [Tile layers](https://doc.arcgis.com/en/arcgis-online/reference/tile-layers.htm) for information that can help you decide which method to use to publish a tile layer.

To publish a hosted tile layer, you must be a member of one of the following in your organization:

* The [default Publisher role](https://doc.arcgis.com/en/arcgis-online/administer/member-roles.htm)
* A custom role that has [privileges](https://doc.arcgis.com/en/arcgis-online/administer/privileges-for-roles-orgs.htm) to create content and publish hosted tile layers

When you publish from ArcGIS Pro, ArcMap, or a tile package, a tile package file is added as an item in your content. Once you confirm that the tile layer functions, you can delete the tile layer package from ArcGIS Online to save storage space, but only do so if you are certain that you no longer need the tile package.

\ <br>


# Release Notes


# Release 1.0.0

Release Date - May 30, 2023

### Known Issues:

| Observed Behavior                                                                                                                                          | What's the solution or workaround?                                                                                                                                                                                                        |  Fixed in latest release?  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------: |
| Adding AOI as a feature layer to map or zooming to it from the Order Dashboard doesn't show the feature on the map.                                        | Before ordering new imagery and drawing your own AOI, it is highly recommended that you save and close out any editing sessions you are currently performing on vector data, as this tool will automatically save any open edit sessions. | Yes, fixed in version 1.17 |
| Drawing an AOI using the AddIn's Draw tool, and then drawing another AOI that's much larger will produce a bug where the 2nd AOI doesn't appear on the map | Remove the EarthCache User AOI Layer from the Table of Contents and from the default Geodatabase. Then, draw the AOI again on the map.                                                                                                    | Yes, fixed in version 1.17 |
| There's no way to edit or deactivate existing pipelines in ArcGIS Pro                                                                                      | Visit [<mark style="color:blue;">console.earthcache.com</mark>](https://skywatch-arcgis.geomarvel.cloud/release-notes/www.console.earthcache.com) in your browser to perform these actions                                                |                            |
| Attempting to log in to the AddIn either does nothing or crashes ArcGIS Pro                                                                                | Your organization likely has a firewall that restricts external URLs. Please visit [System Requirements](/setup/system-requirements) to see the list of URLs to whitelist.                                                                |                            |

Note: If you're experiencing any other issues, please delete the Add-in from ArcGIS Pro and download and reinstall from ArcGIS Marketplace


# Release 1.16

Release Date - August 25, 2023

### What's new?

1. Order Dashboard has been renamed to My Orders
2. A section for EarthCache Enterprise has been added to the top ribbon. Users can view members and groups in their organization as well as see orders made from Enterprise accounts.&#x20;
3. A button has been added to the top ribbon in the Add-in that alerts users if the current version of the Add-in is out of date. The user can then click on the button to download the new version.&#x20;

### Known Issues:

No new known issues. For known issues from previous releases, please see other release notes.

###


# Release 1.17

Release Date - December 21, 2023

### What's new?&#x20;

1. Configuration for cloud storage: You can now add settings for your AWS S3 bucket or Azure Blob storage so imagery can be uploaded directly to cloud, instead of downloading them to your local directory. For more information, see [Configure Cloud Storage](/manual/configure-cloud-storage)
2. Addressed bugs with draw tool not completing polygons in ArcGIS Pro 3.2
3. Text and UI changes throughout Addin


# Release 1.18

Release Date - January 29, 2024

### What's new?&#x20;

1. Updated Maximum AOI limits for Search and Order Imagery


# Contact SkyWatch

<figure><img src="/files/2uufCxzq41yRpzYVZJNK" alt=""><figcaption></figcaption></figure>

If you require assistance with the EarthCache ArcGIS Pro plugin, questions about billing, or a general inquiry, please contact the Support team at [<mark style="color:blue;">support@skywatch.com</mark>](mailto:support@skywatch.com)

For a list of Frequently Asked Questions with EarthCache, see [<mark style="color:blue;">here</mark>](https://support.skywatch.com/hc/en-us/sections/7326357775515-FAQs).

For more information or other general EarthCache inquiries, you can review documentation on the [<mark style="color:blue;">help center</mark>](https://support.skywatch.com/hc/en-us/categories/7326285366811-EarthCache).