适用于 Microsoft Fabric 的 ArcGIS GeoAnalytics （正式发布）

Microsoft和 Esri 已合作将空间分析集成到 Microsoft Fabric 中。 ArcGIS GeoAnalytics 库在 Fabric 中可用。 此库在 Spark 笔记本和用于数据工程和数据科学工作负荷的 Spark 作业定义中启用空间分析。 这种集成允许 Spark 开发人员和数据科学家在 Fabric Spark 中使用 Esri 的 ArcGIS GeoAnalytics 函数和工具进行空间数据转换和分析。 无需任何单独的安装才能使用这些功能。

启用 ArcGIS GeoAnalytics

租户管理员可以在 Fabric 运行时中为所有用户启用或禁用 ArcGIS GeoAnalytics 库。 为此，请登录到 Fabric 门户并导航到 “设置>管理门户”。 在 租户设置中， 为 Fabric 运行时启用 ArcGIS GeoAnalytics。 禁用后，Spark 笔记本或 Spark 作业定义中将不可用。

此外，如果你是容量管理员，则可以在 Fabric 运行时中为使用特定容量的所有用户启用或禁用 ArcGIS GeoAnalytics 库。 默认情况下，容量级别设置继承自租户级别设置，但作为容量管理员，你可以选择通过导航到“设置>>设置并选择容量来替代容量级别设置。 接下来，在“委派租户设置>”下，可以替代和禁用 ArcGIS GeoAnalytics for Fabric 运行时。

许可和成本

适用于 Microsoft Fabric 的 ArcGIS GeoAnalytics 是 Esri 的专有技术。 尽管此库已本机集成到 Microsoft Fabric Spark 中，以减少载入中的摩擦，但你需要自带许可证才能在 Microsoft Fabric 中使用这些功能。 可以从 市场产品/服务 页了解有关许可和成本的详细信息。

Authentication

虽然 ArcGIS GeoAnalytics 库已预安装并预配置，但你可以导入模块以立即开始使用它，但在运行任何函数或工具之前，必须使用有效的许可证对使用情况进行授权。 可以使用 Microsoft Fabric 的用户名和密码或 Esri 提供的 API 密钥对模块进行授权。 如果模块未获得授权，函数和工具将无法运行，并出现以下错误： com.esri.geoanalytics.internal.AuthError: Not authorized. 可在此处了解有关 授权的详细信息。

ArcGIS GeoAnalytics 功能

ArcGIS 为各种应用程序提供了广泛的地理空间功能。 Esri 正在将 ArcGIS 空间分析功能集成到 Microsoft Fabric 中，在 Fabric Spark 环境中提供 ArcGIS GeoAnalytics 函数和工具。 此集成可帮助你分析事件、可视化空间关系以及从数据中获取见解。 这些功能支持各种类型的时空分析，包括以下任务：

用法示例

• 数据工程和数据转换 – 使用数据科学和数据工程中的笔记本，或者在数据工厂中的管道来自动化数据清理、转换和加载。

  

• 热点和聚类分析 - 识别显著的空间聚类，如高值（热点）和低值（冷点）、空间异常点，或类似特征分组：

  

• 空间模式识别和分析 - 深入了解跨区域或时间段的特征和数据 趋势的分布 和数据趋势模式：

  

• 用于数据扩充和位置分析的空间联接 – 基于空间邻近度或跨空间和时间邻近度添加基于位置的上下文。

• 跟踪和移动分析 – 分析 GPS 或其他类型的跟踪数据的模式，以 检测事件、 计算运动统计信息并了解随时间变化的位置变化：

  

• 用于 Power BI 仪表板的聚合和扩充 – 将结果写回到 OneLake 中，以便在 Power BI 中使用。 计划工作流以驱动自动更新：

  

有关所有函数和工具的详细信息，请参阅 ArcGIS GeoAnalytics 开发人员文档。

除了 ArcGIS GeoAnalytics 之外，还可以使用 ArcGIS for Power BI 在 Fabric 中增强空间数据。 它在报表和仪表板中启用自定义数据可视化和空间见解。

这些功能可帮助组织使用地理环境，以提高决策和效率。 在 ArcGIS 体系结构中心和ArcGIS 和 Fabric 集成 站点上了解有关 Esri 的 ArcGIS 产品套件的详细信息。

代码模板和示例

可以在 ArcGIS GeoAnalytics 开发人员文档、 Esri Community for GeoAnalytics for Fabric 和 Fabric 数据工程示例中找到代码模板和示例。

以下示例演示如何通过导入 FindHotSpots 库和设置参数来执行热点分析：

# import the Find Hot Spots tool
from geoanalytics_fabric.tools import FindHotSpots

# Use Find Hot Spots to evaluate the data using bins of 0.1 mile size, and compare to a neighborhood of 0.5 mile around each bin
result_service_calls = FindHotSpots() \
            .setBins(bin_size=0.1, bin_size_unit="Miles") \
            .setNeighborhood(distance=0.5, distance_unit="Miles") \
            .run(dataframe=df)

可以进一步分析和可视化结果，如下所示：

ArcGIS 中的空间数据入门

ArcGIS Living Atlas of the World 提供了各种空间数据集，以开始使用 ArcGIS GeoAnalytics 库。 Living Atlas 是全球最重要的地理信息集合，包括可用于支持 ArcGIS GeoAnalytics 工作的数据层。 可以使用 ArcGIS GeoAnalytics 库将 Living Atlas 中的功能服务读入数据帧，以扩充空间数据。 例如，可以读取包含 美国州几何图形和属性的数据：

# read a feature service hosted in the Living Atlas of the World 

myFS="https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0" 

df = spark.read.format('feature-service').load(myFS) 

此数据现在位于数据帧中，可用于 ArcGIS GeoAnalytics 函数、工具或 Fabric 笔记本中的其他库。 例如，可以使用空间联接关系（例如，使用 ST_Contains 来标识哪些状态多边形包含每个点）来扩充具有状态详细信息的点数据集。

可以将数据帧可视化为表，也可以使用 ArcGIS GeoAnalytics 生成地图。

# plot a dataframe with geometry from a feature service 

df.st.plot(basemap="light", geometry="shape", facecolor="yellow", edgecolor="black", alpha=0.5) 

可支持性

可通过 Esri 社区和 开发人员文档找到对 ArcGIS GeoAnalytics 的支持。

注意事项

• 对几何数据有读/写支持，但并非所有输出格式都支持几何类型。

  • 对于没有本机几何支持的格式，请使用 ST_AsText 和 ST_AsBinary等函数将几何图形转换为字符串或二进制类型（例如，已知二进制、已知文本、GeoJSON）。

  • 写入 Delta 时，ArcGIS GeoAnalytics 会将几何图形转换为已知的二进制格式。 读取这些 Delta 表时，请检查列类型并使用 ST_GeomFromBinary 等函数转换回几何图形。

• 对于身份验证和使用情况跟踪，ArcGIS GeoAnalytics 引擎调用 Fabric 外部的 Esri 服务，因此在启用 出站访问保护 时目前不受支持。

相关内容

• Fabric 中的 Apache Spark 运行时
• 如何使用笔记本
• 本机执行引擎 （NEE）
• 适用于 Microsoft Fabric 的 ArcGIS GeoAnalytics
• 适用于 Microsoft Fabric 的 ArcGIS GeoAnalytics 开发人员文档
• 适用于 Microsoft Fabric 社区的 ArcGIS GeoAnalytics