Skip to content
Merged
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
60 changes: 23 additions & 37 deletions docs/data-engineering/spark-arcgis-geoanalytics.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,42 @@
---
title: ArcGIS GeoAnalytics for Microsoft Fabric (Public Preview)
title: ArcGIS GeoAnalytics for Microsoft Fabric (Generally Available)
description: Learn how to use the ArcGIS GeoAnalytics library in Microsoft Fabric, including data import, enrichment, visualization, and support resources.
ms.reviewer: sngun
ms.author: eur
author: eric-urban
ms.author: arali
author: ms-arali
ms.topic: concept-article
ms.date: 11/19/2024
ms.date: 10/31/2025
#customer intent: As a data scientist or Spark developer, I want to use ArcGIS GeoAnalytics in Microsoft Fabric to perform spatial data transformation and analysis.
---

# ArcGIS GeoAnalytics for Microsoft Fabric (Public preview)
# ArcGIS GeoAnalytics for Microsoft Fabric (Generally Available)

Microsoft and [Esri](https://www.esri.com/) have partnered to integrate spatial analytics into Microsoft Fabric. A new ArcGIS GeoAnalytics library is available in Fabric. This library enables spatial analytics in Spark notebooks and Spark Job Definitions for Data Engineering and Data Science. This integration allows Spark developers and data scientists to use Esri's ArcGIS GeoAnalytics functions and tools within Fabric Spark for spatial data transformation and analysis. You don't need any separate installation to use this capability.
Microsoft and [Esri](https://www.esri.com/) have partnered to integrate spatial analytics into Microsoft Fabric. The ArcGIS GeoAnalytics library is available in Fabric. This library enables spatial analytics in Spark notebooks and Spark Job Definitions for Data Engineering and Data Science workloads. This integration allows Spark developers and data scientists to use Esri's ArcGIS GeoAnalytics functions and tools within Fabric Spark for spatial data transformation and analysis. You don't need any separate installation to use these capabilities.

## Enable ArcGIS GeoAnalytics

Tenant administrators can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users. To do so, sign in to the Fabric portal and navigate to **Settings** > **Admin Portal**. In the **Tenant settings**, enable **ArcGIS GeoAnalytics in Fabric Runtime (preview)**. When disabled, it won't be available in Spark notebooks or Spark job definitions.
Tenant administrators can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users. To do so, sign in to the Fabric portal and navigate to **Settings** > **Admin Portal**. In the **Tenant settings**, enable **ArcGIS GeoAnalytics for Fabric Runtime**. When disabled, it won't be available in Spark notebooks or Spark job definitions.

:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis.png" alt-text="Screenshot showing how to enable ArcGIS geo analytics from tenant settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis.png":::
:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis-tenant.png" alt-text="Screenshot showing how to enable ArcGIS GeoAnalytics from Tenant settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis-tenant.png":::

Additionally, if you are a Capacity administrator you can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users using your specific capacity. By default, capacity level settings are inherited from tenant level settings however you as a capacity administrator can choose to override it at the capacity level by navigating to **Settings** > **Admin Portal** > **Capacity settings** and choose your capacity. Next, under **Delegated tenant settings** > **Integration settings**, you can override and enable or disable **ArcGIS GeoAnalytics for Fabric Runtime**.

:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis-capacity.png" alt-text="Screenshot showing how to enable ArcGIS GeoAnalytics from Capacity settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis-capacity.png":::

## Licensing and cost

ArcGIS GeoAnalytics for Microsoft Fabric is free to use during the public preview, with no license required.
ArcGIS GeoAnalytics for Microsoft Fabric is a proprietary technology from Esri. Though this library has been natively integrated into Microsoft Fabric Spark to reduce the friction in onboarding, you need to bring your own license to use these capabilities within Microsoft Fabric. You can learn more about licensing and cost from [Marketplace offering](https://go.esri.com/arcgis-geoanalytics-for-fabric-marketplace) page.

> [!NOTE]
> ArcGIS is a non-Microsoft product, and you understand and agree that use of ArcGIS is subject to the Esri [Master Agreement](https://www.esri.com/content/dam/esrisites/media/legal/ma-full/ma-full.pdf) and [Privacy Statement](https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement). The current integration is offered and governed under marketplace terms and conditions.
> ArcGIS GeoAnalytics is a non-Microsoft product, and you understand and agree that use of ArcGIS is subject to the Esri [Master Agreement](https://www.esri.com/content/dam/esrisites/media/legal/ma-full/ma-full.pdf) and [Privacy Statement](https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement). The current integration is offered and governed under marketplace terms and conditions.

## Authentication

The ArcGIS GeoAnalytics library is currently available only in [Fabric Runtime 1.3](runtime-1-3.md). During the public preview, no authentication is required. The library is preinstalled and preconfigured, so you can import the modules and start using it.

# [Python](#tab/python)

```python
import geoanalytics_fabric
import geoanalytics_fabric.sql.functions as ST
```

# [Scala](#tab/scala)
Though ArcGIS GeoAnalytics library is preinstalled and preconfigured and you can import the modules to start using it immediately, the usage must be authorized with a valid license before running any function or tool. You can authorize the module with a GeoAnalytics for Microsoft Fabric username and password, or an API key provided by Esri. If the module is not authorized, functions and tools will fail to run with the following error: `com.esri.geoanalytics.internal.AuthError: Not authorized.` Here you can learn more about [Authorization](https://developers.arcgis.com/geoanalytics-fabric/authorization/).

```scala
import com.esri.geoanalytics._
import com.esri.geoanalytics.sql.{functions => ST}
```
---
## ArcGIS GeoAnalytics Capabilities

## ArcGIS capabilities

ArcGIS provides extensive geospatial capabilities for various applications. Esri is integrating the ArcGIS spatial analytics capabilities into Microsoft Fabric, offering ArcGIS GeoAnalytics functions and tools in the Fabric Spark environment. This integration to help you analyze events, visualize spatial relationships, and gain insights from your data. These capabilities enable the following tasks:
ArcGIS provides extensive geospatial capabilities for various applications. Esri is integrating ArcGIS spatial analytics capabilities into Microsoft Fabric, offering ArcGIS GeoAnalytics functions and tools in the Fabric Spark environment. This integration can help you analyze events, visualize spatial relationships, and gain insights from your data. These capabilities enable a variety of spatiotemporal analytics, including the following tasks:

| Task type | Description |
|---------|---------|
Expand Down Expand Up @@ -94,7 +83,7 @@ These capabilities help organizations use geographic context for better decision

You can find code templates and examples in the [ArcGIS GeoAnalytics Developer Documentation](https://developers.arcgis.com/geoanalytics-fabric/), the [Esri Community for GeoAnalytics for Fabric](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric), and Fabric Data Engineering samples.

Here's an example showing how to do hot spot analysis by importing the *FinfHotSopts* library and setting the parameters:
Here's an example showing how to do hot spot analysis by importing the *FindHotSpots* library and setting the parameters:

```python
# import the Find Hot Spots tool
Expand Down Expand Up @@ -143,24 +132,21 @@ df.st.plot(basemap="light", geometry="shape", facecolor="yellow", edgecolor="bla

Support for ArcGIS GeoAnalytics can be found through the [Esri Community](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric), and the [Developer Documentation](https://developers.arcgis.com/geoanalytics-fabric/).

### Current limitations

Currently, this integrated library has the following known limitations:

* ArcGIS GeoAnalytics doesn't currently work with [Native Execution Engine (NEE)](native-execution-engine-overview.md)

* During the public preview, Scala support is available for ArcGIS GeoAnalytics functions but not tools.
### Consideration

* There's read/write support for spatial data as geometries, however, not all output formats support geometry type.

* For formats without native geometry support, convert geometries to string or binary types (for example, well-known binary, well-known text, GeoJSON) using functions like [ST_AsText](https://developers.arcgis.com/geoanalytics-fabric/sql-functions/st_as_text/) and [ST_AsBinary](https://developers.arcgis.com/geoanalytics-fabric/sql-functions/st_as_binary/).

* When writing to Delta, ArcGIS GeoAnalytics converts geometry to a well-known binary format. When reading these Delta tables, check the column type and use functions like [ST_GeomFromBinary](https://developers.arcgis.com/geoanalytics-fabric/sql-functions/st_geom_from_binary/) to convert back to geometry.

* For authentication and usage tracking, the ArcGIS GeoAnalytics engine makes calls to Esri services outside of Fabric and hence currently it is not supported when [Outbound Access Protection](https://learn.microsoft.com/fabric/security/workspace-outbound-access-protection-overview) is enabled.

### Related content

* [Apache Spark runtime in Fabric](runtime.md)
* [How to use notebooks](how-to-use-notebook.md)
* [ArcGIS for Microsoft Fabric](https://go.esri.com/geoanalytics-in-ms-fabric-overview)
* [Native Execution Engine (NEE)](native-execution-engine-overview.md)
* [ArcGIS GeoAnalytics for Microsoft Fabric](https://go.esri.com/geoanalytics-in-ms-fabric-overview)
* [Developer documentation for ArcGIS GeoAnalytics for Microsoft Fabric](https://developers.arcgis.com/geoanalytics-fabric)
* [ArcGIS GeoAnalytics for Microsoft Fabric Community](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric)
2 changes: 1 addition & 1 deletion docs/data-engineering/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -451,7 +451,7 @@ items:
href: graphql-faq.yml
- name: Partner integration
items:
- name: Esri - ArcGIS GeoAnalytics (preview)
- name: Esri - ArcGIS GeoAnalytics
href: spark-arcgis-geoanalytics.md
- name: User data functions
items:
Expand Down