﻿WMTS is available to [Enterprise plan](https://docs.up42.com/getting-started/account-plans) accounts only.

## Overview

Use streaming capabilities to generate a raster map layer composed of pre-rendered image tiles from the [Web map tile service (WMTS)](https://www.ogc.org/standards/wmts/). Layers are used to optimize map display in a GIS application at multiple zoom levels.

## WMTS layers

### Check imagery requirements

WMTS can only be applied to data items that meet the following conditions:

- The data item must be [georectified or orthorectified](https://docs.up42.com/data/geometric-processing#availability).
- The data item must have red, green, and blue [bands](https://docs.up42.com/data/spectral-bands).

To get the best results, use [8-bit](https://docs.up42.com/data/bit-depth#8-bit) data items.

### Generate a layer

This action can’t be done with the Viewer [role](https://docs.up42.com/getting-started/roles).

1. Open the [console](https://console.up42.com/?utm_source=documentation) and go to Data management **Data management** → **Data items**.
2. In the search bar, click Filters. Go to **CNAM status** and select **Transformed data items**. [Adjust](https://docs.up42.com/data-management/assets#search) filters and geographic locations. Click **Search**.
3. In the row of the data item you want to stream, click Layers. If it’s not available, it means the data item doesn’t meet the [imagery requirements](https://docs.up42.com/data-management/streaming#requirements).

### Get a layer URL

1. Open the [console](https://console.up42.com/?utm_source=documentation) and go to Data management **Data management** → **WMTS layers**.
2. Click Copy to copy the WMTS streaming link.

You’ll receive a URL in the following format: `https://api.up42.com/v2/layers/<layer-id>/wmts`. Use this URL for streaming in geospatial software.

### See source data

1. Open the [console](https://console.up42.com/?utm_source=documentation) and go to Data management **Data management** → **WMTS layers**.
2. Access the WMTS layer by clicking on it.
3. In the opened panel, go to **Sources**. Click **Open**.

## Streaming in geospatial software

Set up OAuth

Load WMTS

Set up authentication to access your UP42 data.

[Go to step](https://docs.up42.com#auth)

Load WMTS in your geospatial software.

[Go to step](https://docs.up42.com#wmts)

1

### Set up OAuth

1. [Download](https://qgis.org/download/), install, and open QGIS. Make sure the version you’re using is 3.34 or later.

2. In the top menu bar, go to:

   - On macOS: **QGIS** → **Preferences**
   - On Windows: **Settings** → **Options**

3. Go to **Authentication**, then click **+** to add a new configuration.

4. Set your master authentication password or enter an existing one.

5. In the opened panel, set a name. Click the dropdown and select **OAuth2 authentication**.

6. In **Grant flow**, select **Authorization Code PKCE**.

7. Enter the following values in the respective fields:

   - **Request URL:** `https://auth.up42.com/realms/public/protocol/openid-connect/auth`
   - **Token URL:** `https://auth.up42.com/realms/public/protocol/openid-connect/token`
   - **Client ID:** `up42-qgis`

8. Click **Save**, then **OK**.

1) [Download](https://pro.arcgis.com/en/pro-app/latest/get-started/download-arcgis-pro.htm), install, and open ArcGIS Pro.

2) In the sidebar, go to:

   - If no projects are open: **Settings** → **Options** → **Authentication**
   - If a project is open: **Project** → **Options** → **Authentication**

3) Click **+ Connection** to add a new configuration.

4) Enter a configuration name.

5) In **Type**, select **Custom**.

6) Enter the following values in the respective fields:

   - **Authorization URL:** `https://auth.up42.com/realms/public/protocol/openid-connect/auth`
   - **Token URL:** `https://auth.up42.com/realms/public/protocol/openid-connect/token`
   - **Client ID:** `up42-arc-gis`

7) Click **OK**.

2

### Load WMTS

1. In the top menu bar, go to **Layer** → **Add Layer** → **Add WMS/WMTS Layer**, then click **New**.
2. In the panel that opens, set a name and paste the following link into the **URL** field: `https://api.up42.com/v2/layers/wmts`. This loads all your layers. Alternatively, you can paste the URL of a specific layer.
3. In the **Authentication** section, select your OAuth2 configuration and click **OK**.
4. From the dropdown, select the newly created WMTS connection and click **Connect**.
5. A browser tab opens with the UP42 authentication page. Enter your email and password, then click **Log in**.
6. Select a layer and click **Add**.

1) Create a new map project or open an existing one.
2) In the top menu bar, go to **Insert** → **Connections** → **Server** → **New WMTS Server**.
3) In **Server URL**, paste the following link: `https://api.up42.com/v2/layers/wmts`. This loads all your layers. Alternatively, you can paste the URL of a specific layer.
4) Select the newly created WMTS connection and click **OK**.
5) In the **View** tab, open the **Catalog** panel and go to **Servers**. Drag and drop the layers you want to stream into the **Contents** panel.
