> For the complete documentation index, see [llms.txt](https://learn.spexi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.spexi.com/integrations/getting-started/arcgis-online.md).

# ArcGIS Online

### Orthomosaics

Spexi provides [**WMTS**](#add-spexi-orthomosaics-as-a-wmts-layer) and [**XYZ**](#add-spexi-orthomosaics-as-a-xyz-layer) tile service URLs that you can add directly into ArcGIS Online as a web layer.

**Important:**\
XYZ service URLs cannot be added as a permanent “Item” in your Content, however, ArcGIS Online does support adding external XYZ tile services directly into a web map.

ArcGIS Online allows you to add WMTS layers as a new item by supplying the URL and adding a custom parameter for your API key.

### Add Spexi Orthomosaics as a WMTS Layer

Use this method if you are working with the **WMTS URL** provided in the Spexi Integrations page.

{% stepper %}
{% step %}

#### Copy Your WMTS URL

Use the standard WMTS Capabilities URL like this:

```
https://world.spexi.com/developer-api/mapi/v1/org/ORG_ID/layer/LAYER_ID/raster-tile/WebMercatorQuad/WMTSCapabilities.xml

```

{% endstep %}

{% step %}

#### Add the WMTS Layer in ArcGIS Online

* Log into **ArcGIS Online**
* Go to the top menu → **Content**
* Click **New item**
* In the panel that appears, choose **URL**
* Paste the WMTS URL you copied from Spexi
* Under **Type**, select **WMTS**

ArcGIS Online will verify the endpoint and display configuration options.
{% endstep %}

{% step %}

#### Add Your `api_key` as a Custom Parameter

* Scroll to the **Add Custom Parameters** section
* Click **+ Add Parameter**
  * Enter:
    * **Name:** `api_key`
    * **Value:** *(paste your API key here)*

It should look like:

| Parameter Name | Value                |
| -------------- | -------------------- |
| api\_key       | YOUR\_API\_KEY\_HERE |

* Click **Add**
  {% endstep %}

{% step %}

#### Finalize the Item

* Enter a title (e.g., **Spexi Orthomosaic – WMTS**)
* Choose a folder (optional)
* Add tags such as `Spexi`, `Orthomosaic`, `WMTS`
* Click **Save**

You now have a saved Spexi WMTS layer item inside your AGOL content.
{% endstep %}

{% step %}

#### Add the Layer to a Web Map

* Open the newly created WMTS item
* Click **Open in Map Viewer**

The orthomosaic will load into the AGOL Map Viewer.

If you don’t see imagery immediately:

* Click **Zoom to Layer** from the layer’s overflow menu
  {% endstep %}

{% step %}

#### Share with Your Organization (Optional)

If you want colleagues to access the imagery:

1. Open the WMTS item page
2. Click **Share**
3. Select **Organization** or specific groups
4. Click **Save**
   {% endstep %}
   {% endstepper %}

### Add Spexi Orthomosaics as a XYZ Layer

XYZ layers can be added **directly into a Map Viewer session**:

{% stepper %}
{% step %}

#### Build Your XYZ URL With API Key

From the Spexi Integrations page, take the XYZ template and append your API key:

```
https://world.spexi.com/developer-api/mapi/v1/org/ORG_ID/layer/LAYER_ID/raster-tile/WebMercatorQuad/{z}/{x}/{y}.png?api_key=YOUR_API_KEY

```

Keep `{z}`, `{x}`, and `{y}` exactly as provided.
{% endstep %}

{% step %}

#### Add XYZ Tiles Using “Add Layer from URL”

1. In Map Viewer, click **Add → Add layer from URL**
2. Paste your full XYZ URL (including `?api_key=`)
3. Click **Add**

ArcGIS Online will detect the URL as a valid Web Tiled Layer and display it.
{% endstep %}
{% endstepper %}