# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.spexi.com/integrations/getting-started/arcgis-online.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.