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

# ArcGIS

Stream LumiDB point clouds and rasters into ArcGIS Pro and ArcGIS Online.

Use LumiDB data in ArcGIS Pro and ArcGIS Online. Point clouds stream as an I3S scene layer into ArcGIS Pro and the ArcGIS Online Scene Viewer. Rasters stream as a map service into ArcGIS Pro and ArcGIS Online. You need an [API key](https://docs.lumidb.com/archive-management/api-keys.md) for both. The overview page, [Integrations](https://docs.lumidb.com/integrations.md), explains which link to use for which tool.

### Point clouds in ArcGIS Pro

1. In LumiDB, open the dataset, click **Share** and choose **ArcGIS I3S link**.
2. If your project uses a map in Web Mercator, select **Convert to Web Mercator (EPSG:3857)**. Otherwise leave it cleared.
3. Click **Copy**.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2Fbk88pfXO4ExQ9eV7oCz6%2F02-i3s-link.png?alt=media" alt="The Copy ArcGIS I3S Link dialog with the link, a Web Mercator checkbox and the API key section" width="410"><figcaption><p>The ArcGIS I3S link dialog.</p></figcaption></figure></div>

4. In ArcGIS Pro, open a project with a scene, for example a new **Global Scene**.
5. On the **Map** tab, click **Add Data** and choose **Add Data From Path**.
6. Paste the link, leave **Service Type** as **Automatic** and click **Add**.
7. In the **Server Login** window, enter `apikey` as the username and your API key as the password.

The points appear in the scene. LumiDB streams them as an I3S Point Cloud Scene Layer.

#### Extract points to a file

The layer supports ArcGIS Pro's **Extract LAS** tool. The tool downloads every point inside the area you choose to your computer. To keep it fast, filter the data in LumiDB first, for example to show only buildings, and set a crop area for the extract on the **Environment** tab of the tool.

### Point clouds in the ArcGIS Online Scene Viewer

The Scene Viewer shows 3D scenes. Use the **ArcGIS I3S link** to add a point cloud to it.

1. In LumiDB, open the dataset, click **Share** and choose **ArcGIS I3S link**.
2. Set **Convert to Web Mercator (EPSG:3857)** to match your scene. Select it for a **Global** scene. Leave it cleared for a **Local** scene. Click **Copy**.
3. In ArcGIS Online, open the Scene Viewer. In the left toolbar, click **Add** (the **+** button) and choose **Add layer from URL**.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2F1U3mUn3Vwaq0B9V1YQ2M%2Fsv-01-add-menu.png?alt=media" alt="The Add menu of the ArcGIS Online Scene Viewer with Add layer from URL" width="400"><figcaption><p>Choose Add layer from URL.</p></figcaption></figure></div>

4. Paste the link in **Layer URL** and enter a **Layer name**.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2FFZfDUFUXuRcdhsl7RbZm%2Fsv-02-layer-url.png?alt=media" alt="The Enter layer URL panel of the Scene Viewer with a LumiDB I3S link and the Configure custom parameters button" width="460"><figcaption><p>Paste the I3S link, then open Configure custom parameters.</p></figcaption></figure></div>

5. Under **Custom parameters**, click **Configure custom parameters**. Enter `apikey` as the name and your [API key](https://docs.lumidb.com/archive-management/api-keys.md) as the value.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2FtLM3sSj6T4W8Wg7ps0NT%2Fsv-03-custom-parameters.png?alt=media" alt="The Custom request parameters panel of the Scene Viewer with a parameter named apikey and an empty Value field" width="480"><figcaption><p>Add the apikey parameter.</p></figcaption></figure></div>

6. Go back and add the layer to the scene.

### Rasters in ArcGIS Pro and ArcGIS Online

1. In LumiDB, open the raster, click **Share** and choose **ArcGIS link**.
2. Click **Copy**. The link ends in `MapServer`.
3. In ArcGIS Online, open a map or scene and choose **Add** → **Add layer from URL**. Paste the link and add a custom parameter named `apikey` with your key as the value.
4. In ArcGIS Pro, choose **Map** → **Add Data** → **From Path** and paste the link. Click **Add**. When ArcGIS asks for credentials, enter `apikey` as the username and your key as the password.

ArcGIS receives the tiles in Web Mercator (EPSG:3857).

ArcGIS Pro can also use a **WMTS link**. Add it as a **WMTS Server** connection and send your key in an `Authorization: apikey lumi_your_key_here` header.

### Rasters in the ArcGIS Online Map Viewer

The Map Viewer shows 2D maps. To add a LumiDB raster to it, use the **WMTS link**. Don't use the **ArcGIS I3S link**: I3S is a 3D scene layer format, and the Map Viewer can't open it.

1. In LumiDB, open the raster, click **Share** and choose **WMTS link**.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2FuX8RnNH2nAz2iccaqAEg%2F03-raster-share-menu.png?alt=media" alt="The Share menu of a raster with the WMTS link option highlighted" width="270"><figcaption><p>Choose WMTS link in the raster's Share menu.</p></figcaption></figure></div>

2. Click **Copy**. The link ends in `WMTSCapabilities.xml`.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2Frf7th4Rg5uMSbYGNfZ7U%2F04-wmts-link.png?alt=media" alt="The Copy Raster WMTS link dialog with the Copy button highlighted" width="400"><figcaption><p>Copy the WMTS capabilities URL.</p></figcaption></figure></div>

3. In ArcGIS Online, open the Map Viewer. In the left toolbar, click **Add** (the **+** button) and choose **Add layer from URL**.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2F3jtufRomGK1z8hAjAtLm%2F00-add-menu.png?alt=media" alt="The Add menu of the ArcGIS Online Map Viewer with Add layer from URL" width="310"><figcaption><p>Choose Add layer from URL.</p></figcaption></figure></div>

4. Paste the link in **URL** and set **Type** to **WMTS (OGC)**.
5. Under **Custom parameters**, click **Add custom parameter**. Enter `apikey` as the **Parameter** and your key as the **Value**.
6. Click **Next**. ArcGIS adds the layer to the map.

<div align="left"><figure><img src="https://150512722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMI9s5xLuAdXOTKpfljc3%2Fuploads%2FIzDWo6q0j5BGcyMen4jx%2F01-add-layer-wmts.png?alt=media" alt="The ArcGIS Online Add Layer dialog with a LumiDB WMTS link, the type WMTS (OGC) and an apikey custom parameter" width="640"><figcaption><p>Add the WMTS link in the ArcGIS Online Map Viewer.</p></figcaption></figure></div>

{% hint style="info" %}
Point clouds don't open in the Map Viewer. Use the **ArcGIS I3S link** in the ArcGIS Online Scene Viewer or in ArcGIS Pro.
{% endhint %}

### Troubleshooting

| Problem                                                                 | What to try                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ArcGIS Pro doesn't ask for credentials, or the layer stays empty        | Close ArcGIS Pro completely and open it again. If it still doesn't ask, remove the old LumiDB entry in the Windows Credential Manager (**Control Panel** → **User Accounts** → **Credential Manager** → **Windows Credentials**, then look for `lumidb` under **Generic Credentials**). Then add the link again, or try it in a new project. |
| ArcGIS Pro asks for credentials again when you open an older project    | Enter `apikey` and your key again.                                                                                                                                                                                                                                                                                                           |
| A few points look far too large in ArcGIS                               | In ArcGIS, change the point size of the layer to a fixed size, or adjust its scale factor. See [Style point cloud scene layers](https://doc.arcgis.com/en/arcgis-online/create-maps/scene-style-pcl.htm).                                                                                                                                    |
| **Extract LAS** is slow or fails                                        | Filter the data in LumiDB, set a crop area for the extract, and try again. If it still fails, write to <help@lumidb.com> and include the time of the attempt.                                                                                                                                                                                |
| The ArcGIS Online Map Viewer rejects the link, or the layer stays empty | The Map Viewer can't open the **ArcGIS I3S link**. For a point cloud, use the Scene Viewer. For a raster, copy the **WMTS link** instead and add it with **Add layer from URL** as type **WMTS (OGC)**. See [Rasters in the ArcGIS Online Map Viewer](#rasters-in-the-arcgis-online-map-viewer).                                             |
| An I3S layer takes a long time to load, or ArcGIS times out             | LumiDB builds I3S layers in the background, and the build continues after a request times out. Wait a moment and add or refresh the layer again. A request that uses a classification filter over a large area can still be slow. Clip the area or filter less data first.                                                                   |
| The data appears in the wrong place                                     | Check the projection of the dataset. See [Coordinate systems and projections](https://docs.lumidb.com/import-data/coordinate-systems-and-projections.md).                                                                                                                                                                                    |
| ArcGIS says the key is wrong                                            | Check that you copied the whole key and that it hasn't expired or been revoked on the [API keys](https://docs.lumidb.com/archive-management/api-keys.md) page.                                                                                                                                                                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lumidb.com/integrations/arcgis.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
