ArcGIS Online

Orthomosaics

Spexi provides WMTS and XYZ 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.

1

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

2

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.

3

Add Your api_key as a Custom Parameter

• Scroll to the Add Custom Parameters section

• Click + Add Parameter

  • Enter:

    • Name: x-api-key

    • Value: (paste your API key here)

It should look like:

Parameter Name	Value
x-api-key	YOUR_API_KEY_HERE

• Click Add

4

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.

5

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

6

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

Add Spexi Orthomosaics as a XYZ Layer

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

1

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.

2

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.