通过

ArcGIS

ArcGIS 将自动化工作流连接到 ArcGIS 组织中的资源。 访问 GeoEnrichment、地理编码和路由服务，以向数据添加人口统计信息和位置信息。 还可以使用连接器创建特征层，并从 ArcGIS 组织中的现有特征层提取数据。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Esri Power Automate 支持
URL https://support.esri.com/en-us/contact
Email support@esri.com
连接器元数据
发布者 Esri， Inc.
网站 https://www.esri.com/en-us/arcgis/products/arcgis-for-microsoft-365/
隐私策略 https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement
类别 IT作;商业智能
ArcGIS for Power Automate 问题 https://community.esri.com/t5/arcgis-for-power-automate-questions/bd-p/arcgis-for-power-automate-questions
版本 2025.3.0

ArcGIS 连接器利用 ArcGIS Online 组织中可用的基于位置的服务来增强对数据驱动决策的理解、见解和支持，从而帮助你获取位置智能。 它提供扩充业务数据、从空间上启用来自外部数据源的信息以及从托管功能服务访问基于位置的详细信息的功能。

Documentation

有关其他文档和信息，请访问 适用于 Power Automate 的 ArcGIS 连接器文档。

先决条件

必须使用属于 ArcGIS Online 组织的 ArcGIS 帐户才能使用此连接器。

如何获取 ArcGIS 帐户

如果没有 ArcGIS 帐户，可以创建 ArcGIS 帐户。 公共帐户对功能有限制。 若要使用此连接器中的大多数作，需要一个组织 ArcGIS 帐户。

如果没有 ArcGIS Online 组织，可以先 注册 试用组织。

如果组织已有 ArcGIS Online 订阅，请联系管理员或 IT 部门，请求向 ArcGIS Online 组织添加或邀请。

ArcGIS 连接器入门

若要使用许多可用作，必须为 ArcGIS 帐户分配有权访问特定权限的角色。 请参阅下表中每个作所需的特权：

Action 权限
GeoEnrichment GeoEnrichment
查找候选地址 地理编码
地理编码地址 地理编码
点到点路由 网络分析
创建特征层 发布托管功能层

Authentication

Microsoft和 Esri 都有严格的安全要求来维护和刷新帐户信息。 若要保持登录状态，流应在给定令牌超时期限内至少运行一次。

局限性

对大型数据集使用地理编码地址或从特征层作中获取数据时，作的输入需要批处理到多个单个请求中。

Name |  Limit
--- | --- |
Geocode addresses   | 150 rows per request

|从特征层获取数据 |每个请求最多 1000 行 |点到点路由 |每个请求 150 次停止

常见错误

  • 缺少令牌或错误的登录凭据。 检查连接和凭据，然后重试。
  • 从 www.arcgis.com 提取数据失败。这通常是由已过期的身份验证令牌无效引起的。 请重新进行身份验证以继续。：如果从某个作收到其中任一错误，则 ArcGIS 令牌已过期。 请再次登录到 ArcGIS 以重置令牌。

限制

名称 调用 续订期
每个连接的 API 调用数 250 60 秒

操作

GeoEnrichment

使用 GeoEnrichment 服务，使用全球人口统计、行为和放置数据来丰富数据。
Geoenrichment [已弃用]

此作已弃用。 请改用 GeoEnrichment 。

获取有关位置或区域的事实。 使用 GeoEnrichment 服务，可以获取有关特定区域中的人员、地点和企业的信息，或者从某个位置到达特定距离或开车时间。 （已弃用）
从 URL 获取附件

使用附件 URL 从功能层中的记录获取附件。
从功能层提取更新、更改或删除

检索对所选特征层进行的更新、更改或删除。 必须将此作与 ArcGIS 触发器结合使用，才能检索有关特征层的任何更改的信息。
从功能层提取更新、更改或删除 [已弃用]

此作已弃用。 请改 用功能层中的提取更新、更改或删除 。

检索对所选特征层进行的更新、更改或删除。 必须将此作与 ArcGIS 触发器结合使用，才能检索有关特征层的任何更改的信息。
从功能层获取数据 [已弃用]

此作已弃用。 请改 用从特征层获取数据 。

连接到 ArcGIS 中的特征层，并将其数据和属性拉取到现有数据集或创建新数据集。 此数据可用于在所有 ArcGIS for Microsoft 365 产品中创建新地图。
从映像中提取 EXIF 标记

使用可用信息从图像中提取 EXIF 元数据和标记。
从特征层中删除记录

使用输入 ID 从特征层中删除一个或多个记录（行）。
从特征层获取几何图形 [已弃用]

从特征层获取几何图形或边界信息，并将其导出为 Esri JSON 或数据集中的形状列。 此数据可用于所有 ArcGIS Microsoft 365 产品。
从特征层获取几何图形 [已弃用]

从特征层获取几何图形或边界信息，并将其导出为 Esri JSON 或数据集中的形状列。 此数据可用于所有 ArcGIS Microsoft 365 产品。
从特征层获取数据

连接到 ArcGIS 中的特征层以查询数据、属性和几何图形。 指定字段、比较类型和筛选器值，或者对复杂查询使用高级 SQL 语法。 使用另一个几何图形或缓冲区优化筛选器。 使用输出跨 ArcGIS 为 Microsoft 产品创建新的地图或数据集。
从特征层获取编码值域

检索一组可接受的属性值（域）。 属性域为表或特征类中的属性定义允许的值。 当特征类中的特征或表中的非空间数据组织为子类型时，可以为每个子类型分配特定的属性域。
创建报表

在 ArcGIS Survey123 中生成报表。
创建点几何图形

从经度 （X） 和纬度 （Y） 值创建点几何对象。
创建特征层

使用现有源（如 SharePoint 列表）中的数据在 ArcGIS 中创建特征层。 特征层是类似地理特征的分组，例如建筑物、包裹、城市、道路和地震震中。 特征可以是点、线条或多边形（区域）。 特征层最适合在底图上可视化数据。
删除附件

从特征层中的记录中删除附件。
删除附件 [已弃用]

此作已弃用。 请改用 “删除附件 ”。

从特征层中的记录（行）中删除附件。
反向地理编码

从经度 （X） 和纬度 （Y） 值检索位置的地址。
在特征层中创建记录

在特征层中创建新记录（行）。
在特征层中创建记录 [已弃用]

此作已弃用。 请改 用特征层中的“创建记录 ”。

此作将新记录添加到特征层。
地理编码地址

查找多个（批处理）地址、地名和企业，然后在地图上显示该信息。 生成的数据可以添加到新的或现有的数据集。 数据还可用于在 ArcGIS 中为 Microsoft 产品创建新地图。
地理编码地址 [已弃用]

此作已弃用。 请改用 地理编码地址 。

查找多个（批处理）地址、地名和企业，然后在地图上显示该信息。 可将此数据添加到现有数据集，也可以创建新的数据集。 此数据可用于在所有 ArcGIS for Microsoft 365 产品中创建新地图。
将记录添加到特征层（批处理）

此作将多个新记录（行）添加到现有特征层。
执行几何计算

使用 ArcGIS Geometry Service 实用工具方法（如区域和长度、缓冲区等）提供对复杂且常用几何作的访问。
更新特征层中的记录

更新特征层中的现有记录（行）。
更新特征层中的记录 [已弃用]

此作已弃用。 请改用 特征层中的记录 。

此作更新特征层中的现有记录。
更新特征层中的记录（批处理）

批处理编辑与唯一 ID 匹配的现有特征层中的多个记录（行）。
更新附件

将附件更新到特征层中的记录。
查找候选地址 [已弃用]

此作已弃用，请改用“查找地址候选项”作。 使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。
查找候选地址 [已弃用]

此作已弃用，请改用“查找地址候选项”作。 使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。
查找地址候选项

使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。
查询附件

搜索与特征层中的记录关联的附件。
添加附件

将附件添加到特征层中的记录（特征）。
点到点路由

创建点到点路由。 可以按指定顺序或最有效的路线访问路线中的点，以尽量减少行程时间。 路线表示沿着道路访问站（点位置）的最快速或最短的路径。
点到点路由 [已弃用]

此作已弃用。 请改用 点到点路由 。

创建点到点路由。 路线中的点可以按指定的顺序访问，也可以按最小化总体行程时间或距离的顺序访问。 路线表示沿道路访问站或点位置的最快速或最短的路径。
获取调查

检索用户帐户拥有的 Survey123 调查列表。
获取附件

从特征层中的记录获取附件。
获取项信息

获取项目信息返回特定组织项的信息。
转换日期和时间格式

在 Epoch Unix 时间戳和字符串格式之间进行转换。
运行数据管道

运行一个数据管道，该管道可自动执行数据准备工作流，并使 ArcGIS 中的功能层保持最新。

GeoEnrichment

操作 ID:
Geoenrich_V2

使用 GeoEnrichment 服务，使用全球人口统计、行为和放置数据来丰富数据。

参数

名称 密钥 必需 类型 说明
国家
 country True string

选择一个国家/地区以查看可用的数据收集
数据收集
 datacollection True string

选择数据收集
Variable
 parameter True string

从集合中选择变量
缓冲区类型
 buffertype True string

位置周围的缓冲区类型
身体
 body True dynamic

返回

名称 路径 类型 说明
变量的值
 value number

Geoenrichment 变量值
变量的名称
 parameterName string

在地理扩充过程中要分析的变量的名称。
单位
 units string

参数单位

Geoenrichment [已弃用]

操作 ID:
Geoenrich

此作已弃用。 请改用 GeoEnrichment 。

获取有关位置或区域的事实。 使用 GeoEnrichment 服务，可以获取有关特定区域中的人员、地点和企业的信息，或者从某个位置到达特定距离或开车时间。 （已弃用）

参数

名称 密钥 必需 类型 说明
研究区域
 studyarea True string

地址或几何图形
国家
 country True string

选择一个国家/地区以查看可用的数据收集
数据收集
 datacollection True string

选择数据收集
Variable
 parameter True string

从集合中选择变量
缓冲区类型
 areatype string

位置周围的缓冲区类型
查询
 query dynamic
空间引用系统
 srs string

选择空间引用系统

返回

名称 路径 类型 说明
变量的值
 value number

Geoenrichment 变量值
变量的名称
 parameterName string

在地理扩充过程中要分析的变量的名称。
单位
 units string

参数单位

从 URL 获取附件

操作 ID:
GetAttachmentFromUrl

使用附件 URL 从功能层中的记录获取附件。

参数

名称 密钥 必需 类型 说明
附件 URL
 attachmentUrl True string

与特征层中记录中的附件关联的 URL。

返回

附件的内容。

附件内容
binary

从功能层提取更新、更改或删除

操作 ID:
WebhookGetAsync

检索对所选特征层进行的更新、更改或删除。 必须将此作与 ArcGIS 触发器结合使用，才能检索有关特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
从中获取更改
 changesUrl True string

从“动态内容”窗格中选择“更改 URL”选项。
特征层
 userLayer True string

已更改、更新或删除的功能层的名称。
特征层 ID
 layerId True number

从“动态内容”窗格中选择“功能层 ID”选项。
数据
 data True dynamic

返回

此操作输出是动态内容。

从功能层提取更新、更改或删除 [已弃用]

操作 ID:
WebhookGet

此作已弃用。 请改 用功能层中的提取更新、更改或删除 。

检索对所选特征层进行的更新、更改或删除。 必须将此作与 ArcGIS 触发器结合使用，才能检索有关特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
从中获取更改
 changesUrl True string

从“动态内容”窗格中选择“更改 URL”选项。
特征层
 userLayer True string

已更改、更新或删除的功能层的名称。
特征层 ID
 layerId True number

从“动态内容”窗格中选择“功能层 ID”选项。

返回

此操作输出是动态内容。

从功能层获取数据 [已弃用]

操作 ID:
GetFeatureLayerData

此作已弃用。 请改 用从特征层获取数据 。

连接到 ArcGIS 中的特征层，并将其数据和属性拉取到现有数据集或创建新数据集。 此数据可用于在所有 ArcGIS for Microsoft 365 产品中创建新地图。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
可用字段
 field string

从 ArcGIS 特征层中选择属性
比较类型
 comparison string

使用比较运算符（例如“等于”或“大于”）搜索值
输出格式
 format True string

选择返回格式类型
搜索参数值
 parameter string

输入要搜索的值
位置
 where string

输入 WHERE 子句以筛选搜索中的记录
返回几何图形
 returnGeometry boolean

返回几何图形
起始计数
 offset number

批处理时，此值是查询的起点

返回

此操作输出是动态内容。

从映像中提取 EXIF 标记

操作 ID:
EXIF

使用可用信息从图像中提取 EXIF 元数据和标记。

参数

名称 密钥 必需 类型 说明
图像
 data True binary

来自其他作的文件内容，例如“获取文件内容”（OneDrive、Share Point）

返回

此操作输出是动态内容。

从特征层中删除记录

操作 ID:
DeleteItemInFeatureLayer

使用输入 ID 从特征层中删除一个或多个记录（行）。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
唯一 ID 字段
 idField True string

在特征层中选择唯一的 ID 字段
删除记录
 deletedIds string

用于标识已删除项的列表或单个 ID 值。 提供的 ID 必须与特征层中使用的 ID 匹配。 可以添加多个 ID，并使用逗号分隔。

返回

名称 路径 类型 说明
array of object
删除状态
 success boolean

删除作成功状态
对象标识符
 objectId number

已删除记录的对象 ID
全局 ID
 globalId string

已删除记录的全局 ID

从特征层获取几何图形 [已弃用]

操作 ID:
GetFLBoundariesV1

从特征层获取几何图形或边界信息，并将其导出为 Esri JSON 或数据集中的形状列。 此数据可用于所有 ArcGIS Microsoft 365 产品。

参数

名称 密钥 必需 类型 说明
国家
 searchterm True string

选择一个国家/地区以查看可用的数据收集
特征层
 layer True string

选择特征层
领域
 field True string

选择字段
搜索参数
 parameter True string

输入搜索参数
Second Field
 field2 string

选择字段
第二个搜索参数
 parameter2 string

输入第二个搜索参数

返回

名称 路径 类型 说明
Geometry 对象
 data object

Geometry 对象作为 JSON 字符串

从特征层获取几何图形 [已弃用]

操作 ID:
GetFLBoundaries

从特征层获取几何图形或边界信息，并将其导出为 Esri JSON 或数据集中的形状列。 此数据可用于所有 ArcGIS Microsoft 365 产品。

参数

名称 密钥 必需 类型 说明
国家
 searchterm True string

选择一个国家/地区以查看可用的数据收集
特征层
 layer True string

选择特征层
领域
 field True string

选择字段
搜索参数
 parameter True string

输入搜索参数
Second Field
 field2 string

选择字段
第二个搜索参数
 parameter2 string

输入第二个搜索参数

返回

名称 路径 类型 说明
Geometry 对象
 data object

Geometry 对象作为 JSON 字符串

从特征层获取数据

操作 ID:
QueryFeatureLayerData

连接到 ArcGIS 中的特征层以查询数据、属性和几何图形。 指定字段、比较类型和筛选器值，或者对复杂查询使用高级 SQL 语法。 使用另一个几何图形或缓冲区优化筛选器。 使用输出跨 ArcGIS 为 Microsoft 产品创建新的地图或数据集。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
输出格式
 format True string

选择返回格式类型
显示统计信息
 useStatistics boolean

显示统计信息字段
数据
 data True dynamic

返回

此操作输出是动态内容。

从特征层获取编码值域

操作 ID:
GetCodedDomains

检索一组可接受的属性值（域）。 属性域为表或特征类中的属性定义允许的值。 当特征类中的特征或表中的非空间数据组织为子类型时，可以为每个子类型分配特定的属性域。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层

返回

此操作输出是动态内容。

创建报表

操作 ID:
FeatureReportSubmitJob

在 ArcGIS Survey123 中生成报表。

参数

名称 密钥 必需 类型 说明
调查
 surveyItemId True string

从 ArcGIS 内容中选择调查
特征层
 featureLayerUrl True string

从 ArcGIS 内容中选择 Survey123 功能层
报表模板
 templateItemId True string

选择 Survey123 报表模板
功能对象 ID
 objectIds string

使用 ObjectID 选择功能;用逗号分隔多个 ObjectID
Feature WHERE 子句
 where string

输入 WHERE 子句以筛选搜索中的记录
UTC 时差
 utcOffset string

为时区应用偏移量;例如 +02：00 或 -09：00
报告名
 outputFileName string

输入报表的名称
Format
 outputFormat string

生成的报表的文件格式

返回

名称 路径 类型 说明
jobId
 jobId string

生成功能报告的作业 ID
jobStatus
 jobStatus string

生成功能报告的作业的状态
提交
 submitted integer

提交作业的时间时间戳（以毫秒为单位）
完成
 completed integer

作业完成时间的时间戳（以毫秒为单位）
title
 resultInfo.title string

报表的名称
totalCount
 resultInfo.totalCount integer

生成的功能报告总数
succeededObjectIds
 resultInfo.succeededObjectIds array of integer

已成功添加到报表的 ObjectID
failedObjectIds
 resultInfo.failedObjectIds array of

未能添加到报表中的 ObjectID
详情
 resultInfo.details array of

生成的报表的详细信息
resultFiles
 resultInfo.resultFiles array of object

已完成作业的所有报表的输出
objectIds
 resultInfo.resultFiles.objectIds array of integer

objectIds
姓名
 resultInfo.resultFiles.name string

姓名
size
 resultInfo.resultFiles.size integer

size
状态
 resultInfo.resultFiles.status string

状态
网址
 resultInfo.resultFiles.url string

网址
objectIds
 resultInfo.resultFile.objectIds array of integer

已成功添加到多个报表列表中的第一个报表文件的 ObjectID
姓名
 resultInfo.resultFile.name string

多个报表列表中的第一个报表文件的名称
size
 resultInfo.resultFile.size integer

多个报表列表中的第一个报表文件的大小
状态
 resultInfo.resultFile.status string

多个报表列表中的第一个报表文件的状态
网址
 resultInfo.resultFile.url string

多个报表列表中的第一个报表文件的 URL
jobType
 inputInfo.jobType string

为作运行的作业类型;例如 createReport
featureLayerUrl
 inputInfo.parameters.featureLayerUrl string

与调查关联的特征层的 URL
objectIds
 inputInfo.parameters.queryParameters.objectIds string

输入的 objectID（s）以包含在报表中
templateItemId
 inputInfo.parameters.templateItemId string

报表模板的 ID
surveyItemId
 inputInfo.parameters.surveyItemId string

在“创建报表”作中选择的调查的 itemID
portalUrl
 inputInfo.parameters.portalUrl string

与调查和报表关联的门户 URL
输出格式
 inputInfo.parameters.outputFormat string

生成的报表的格式

创建点几何图形

操作 ID:
CreatePointGeometryHelper

从经度 （X） 和纬度 （Y） 值创建点几何对象。

参数

名称 密钥 必需 类型 说明
经度 （X）
 x True number

经度 （X）
纬度 （Y）
 y True number

纬度 （Y）
空间引用系统
 srs string

选择空间引用系统

返回

名称 路径 类型 说明
Geometry
 geometry object

点几何对象

创建特征层

操作 ID:
CreateFeatureLayer

使用现有源（如 SharePoint 列表）中的数据在 ArcGIS 中创建特征层。 特征层是类似地理特征的分组，例如建筑物、包裹、城市、道路和地震震中。 特征可以是点、线条或多边形（区域）。 特征层最适合在底图上可视化数据。

参数

名称 密钥 必需 类型 说明
Title
 layerTitle True string

新功能层的标题
库位类型
 locationType string

列中的位置信息的类型
身体
 body True dynamic

返回

名称 路径 类型 说明
服务项 ID
 serviceItemId string

服务项 ID
服务 URL
 serviceurl string

服务 URL
服务类型
 type string

已创建服务类型
库位类型
 locationType string

用于匹配位置的位置类型

删除附件

操作 ID:
DeleteAttachments

从特征层中的记录中删除附件。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
记录 ID
 objectid True number

与附件关联的记录的对象 ID
附件 ID（s）
 attachmentIds True string

特征层记录中附件的 ID（s）

返回

名称 路径 类型 说明
array of object
对象标识符
 objectId number
全局 ID
 globalId string
成功
 success boolean

删除附件 [已弃用]

操作 ID:
DeleteAttachment

此作已弃用。 请改用 “删除附件 ”。

从特征层中的记录（行）中删除附件。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
记录 ID
 objectid True number

与附件关联的记录的对象 ID
附件 ID
 attachmentId True number

特征层记录中附件的 ID。

返回

名称 路径 类型 说明
array of object
对象标识符
 objectId number
全局 ID
 globalId string
成功
 success boolean

反向地理编码

操作 ID:
ReverseGeocode

从经度 （X） 和纬度 （Y） 值检索位置的地址。

参数

名称 密钥 必需 类型 说明
地理编码器
 geocoder True string

选择可用的地理编码器。
经度 （X）
 x True number

经度 （X）
纬度 （Y）
 y True number

纬度 （Y）
空间引用系统
 srs string

选择空间引用系统
匹配类型
 locationType string

指定是对几何图形输出使用屋顶还是街道入口位置

返回

名称 路径 类型 说明
短地址
 address.Address string

位置的简短地址
完整地址
 address.LongLabel string

位置的完整地址
City
 address.City string

位置的城市
区域
 address.Region string

位置的区域
国家
 address.CntryName string

位置的国家/地区
ZIP 或邮政编码
 address.Postal string

位置的邮政编码
经度 （X）
 location.x number

经度 （X）
纬度 （Y）
 location.y number

纬度 （Y）

在特征层中创建记录

操作 ID:
CreateItemInFeatureLayerDomains

在特征层中创建新记录（行）。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
数据
 data True dynamic

返回

名称 路径 类型 说明
创建作成功状态
 success boolean

创建状态
对象标识符
 objectId number

所创建记录的对象 ID
全局 ID
 globalId string

已创建记录的全局 ID

在特征层中创建记录 [已弃用]

操作 ID:
CreateItemInFeatureLayer

此作已弃用。 请改 用特征层中的“创建记录 ”。

此作将新记录添加到特征层。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
数据
 data True dynamic

返回

名称 路径 类型 说明
创建作成功状态
 success boolean

创建状态
对象标识符
 objectId number

所创建记录的对象 ID
全局 ID
 globalId string

已创建记录的全局 ID

地理编码地址

操作 ID:
GeocodeAddressesV2

查找多个（批处理）地址、地名和企业，然后在地图上显示该信息。 生成的数据可以添加到新的或现有的数据集。 数据还可用于在 ArcGIS 中为 Microsoft 产品创建新地图。

参数

名称 密钥 必需 类型 说明
地理编码器
 geocoder True string

选择可用的地理编码器
Addresses
 addresses True string

具有格式良好的字段的地址数组

返回

此操作输出是动态内容。

地理编码地址 [已弃用]

操作 ID:
GeocodeAddresses

此作已弃用。 请改用 地理编码地址 。

查找多个（批处理）地址、地名和企业，然后在地图上显示该信息。 可将此数据添加到现有数据集，也可以创建新的数据集。 此数据可用于在所有 ArcGIS for Microsoft 365 产品中创建新地图。

参数

名称 密钥 必需 类型 说明
Addresses
 addresses True string

具有格式良好的字段的地址数组

返回

名称 路径 类型 说明
空间引用 ID
 spatialReference.wkid number

已知 ID
位置
 locations array of object

地理编码位置数组
地址
 locations.address string

完整地址
地址 ID
 locations.attributes.ResultID number

此值包含地理编码请求的 ID。 使用此值可指定要在其他作（例如列表中的匹配 ID）中作的项目。
经度 （X）
 locations.location.x number
纬度 （Y）
 locations.location.y number

将记录添加到特征层（批处理）

操作 ID:
AddFeaturesBatch

此作将多个新记录（行）添加到现有特征层。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
身体
 body True dynamic

返回

Body
batchAddUpdateFeatures

执行几何计算

操作 ID:
GeometryService

使用 ArcGIS Geometry Service 实用工具方法（如区域和长度、缓冲区等）提供对复杂且常用几何作的访问。

参数

名称 密钥 必需 类型 说明
几何运算
 operation True string

选择要执行的作
数据
 data True dynamic

返回

此操作输出是动态内容。

更新特征层中的记录

操作 ID:
UpdateItemInFeatureLayerDomains

更新特征层中的现有记录（行）。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
唯一 ID 字段
 idField True string

在特征层中选择唯一的 ID 字段
数据
 data True dynamic

返回

名称 路径 类型 说明
更新作成功状态
 success boolean

更新状态
对象标识符
 objectId number

已更新记录的对象 ID
全局 ID
 globalId string

已更新记录的全局 ID

更新特征层中的记录 [已弃用]

操作 ID:
UpdateItemInFeatureLayer

此作已弃用。 请改用 特征层中的记录 。

此作更新特征层中的现有记录。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
唯一 ID 字段
 idField True string

在特征层中选择唯一的 ID 字段
数据
 data True dynamic

返回

名称 路径 类型 说明
更新作成功状态
 success boolean

更新状态
对象标识符
 objectId number

已更新记录的对象 ID
全局 ID
 globalId string

已更新记录的全局 ID

更新特征层中的记录（批处理）

操作 ID:
UpdateFeaturesBatch

批处理编辑与唯一 ID 匹配的现有特征层中的多个记录（行）。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
唯一 ID 字段
 idField True string

在特征层中选择唯一的 ID 字段
身体
 body True dynamic

返回

Body
batchAddUpdateFeatures

更新附件

操作 ID:
UpdateAttachment

将附件更新到特征层中的记录。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
对象标识符
 objectid True number

与附件关联的记录的对象 ID
要更新的附件
 attachmentId True number

选择更新的附件名称或输入附件 ID
更新的附件名称
 attachmentName True string

已更新文件的名称
文件内容
 data True binary

来自其他作的文件内容，例如“获取文件内容”（OneDrive、Share Point）

返回

名称 路径 类型 说明
对象标识符
 objectId number
全局 ID
 globalId string
成功
 success boolean

查找候选地址 [已弃用]

操作 ID:
FindAddressCandidates

此作已弃用，请改用“查找地址候选项”作。 使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。

参数

名称 密钥 必需 类型 说明
存储结果？
 forStorage True boolean

指定是否将持久保存作的结果。
地址
 address string

地址
区域
 region string

区域
City
 city string

City
ZIP 或邮政编码
 postal string

ZIP 或邮政编码
国家
 country string

选择国家/地区
匹配类型
 locationType string

指定是对几何图形输出使用屋顶还是街道入口位置
空间引用系统
 srs string

选择空间引用系统

返回

名称 路径 类型 说明
完整地址
 address string

数据的位置作为单行或多行结果列出
国家/地区代码
 countryCode string

位置所在的国家/地区
City
 city string

位置所在的城市
经度 （X）
 Geometry.x number

经度 （X）
纬度 （Y）
 Geometry.y number

纬度 （Y）
得分
 score number

匹配分数。

查找候选地址 [已弃用]

操作 ID:
FindAddressCandidate

此作已弃用，请改用“查找地址候选项”作。 使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。

参数

名称 密钥 必需 类型 说明
存储结果？
 forStorage True boolean

指定是否将持久保存作的结果。
地址
 address string

地址
区域
 region string

区域
City
 city string

City
ZIP 或邮政编码
 postal string

ZIP 或邮政编码
国家
 country string

选择国家/地区
匹配类型
 locationType string

指定是对几何图形输出使用屋顶还是街道入口位置
空间引用系统
 srs string

选择空间引用系统

返回

名称 路径 类型 说明
完整地址
 address string

数据的位置作为单行或多行结果列出
国家/地区代码
 countryCode string

位置所在的国家/地区
City
 city string

位置所在的城市
经度 （X）
 Geometry.x number

经度 （X）
纬度 （Y）
 Geometry.y number

纬度 （Y）
得分
 score number

匹配分数。

查找地址候选项

操作 ID:
FindAddressCandidatesV2

使用地理编码服务查找单个地址。 此作返回具有最高匹配分数的顶级地址候选地址，以及与位置相关的其他信息。

参数

名称 密钥 必需 类型 说明
地理编码器
 geocoder True string

选择可用的地理编码器。
身体
 body True dynamic
匹配类型
 locationType string

指定是对几何图形输出使用屋顶还是街道入口位置
空间引用系统
 srs string

选择空间引用系统

返回

此操作输出是动态内容。

查询附件

操作 ID:
QueryAttachment

搜索与特征层中的记录关联的附件。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
记录 ID
 objectId True number

与附件关联的记录的对象 ID
关键字
 keywords string

用于标识附件的关键字

返回

名称 路径 类型 说明
array of object
附件对象 ID
 id number
附件全局 ID
 globalId string
附件名称
 name string
Content-type
 contentType string
附件大小
 size number
关键字
 keywords string
附件 URL
 url string

添加附件

操作 ID:
AddAttachment

将附件添加到特征层中的记录（特征）。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
记录 ID
 objectId True number

与附件关联的记录的对象 ID
附件名称
 attachmentName True string

将附加的文件的名称
文件内容
 data True binary

来自其他作的文件内容，例如“获取文件内容”（OneDrive、Share Point）
关键字
 keywords string

用于标识附件的关键字

返回

名称 路径 类型 说明
对象标识符
 objectId number
全局 ID
 globalId string
成功
 success boolean

点到点路由

操作 ID:
GetRouteV2

创建点到点路由。 可以按指定顺序或最有效的路线访问路线中的点，以尽量减少行程时间。 路线表示沿着道路访问站（点位置）的最快速或最短的路径。

参数

名称 密钥 必需 类型 说明
路由停止
 stops True string

停止为纬度 （Y） 和经度 （X）， 特征或功能服务
旅行模式
 travelModeName string

选择旅行模式
查找最佳路线
 findBestSequence boolean

指定服务是否应重新排序以查找优化的路由
保留第一个停止
 preserveFirstStop boolean

指示在重新排序停止时，服务是否应将第一个停止保持固定
返回方向
 returnDirections boolean

指定服务是否应为每个路线生成驾驶路线

返回

名称 路径 类型 说明
方向
 Directions array of object
方向文本
 Directions.text string
Name
 Name string

路由的名称
以公里为单位的距离
 Kilometers number

路线距离（以公里为单位）
以英里为单位的距离
 Miles number

以英里为单位的路线距离
旅行时间
 TravelTime number

估计的行程时间（以分钟为单位）
路由几何图形
 Geometry object

路由的 Geometry 对象

点到点路由 [已弃用]

操作 ID:
GetRoute

此作已弃用。 请改用 点到点路由 。

创建点到点路由。 路线中的点可以按指定的顺序访问，也可以按最小化总体行程时间或距离的顺序访问。 路线表示沿道路访问站或点位置的最快速或最短的路径。

参数

名称 密钥 必需 类型 说明
路由停止
 stops True string

停止为纬度 （Y） 和经度 （X）， 特征或功能服务
旅行模式
 travelModeName string

选择分析的运输模式
查找最佳路线
 findBestSequence boolean

指定服务是否应重新排序以查找优化的路由
保留第一个停止
 preserveFirstStop boolean

指示在重新排序停止时，服务是否应将第一个停止保持固定
返回方向
 returnDirections boolean

指定服务是否应为每个路线生成驾驶路线

返回

名称 路径 类型 说明
方向
 Directions array of object
方向文本
 Directions.text string
Name
 Name string

路由的名称
以公里为单位的距离
 Kilometers number

路线距离（以公里为单位）
以英里为单位的距离
 Miles number

以英里为单位的路线距离
旅行时间
 TravelTime number

估计的行程时间（以分钟为单位）
路由几何图形
 Geometry object

路由的 Geometry 对象

获取调查

操作 ID:
GetOwnedSurveyList

检索用户帐户拥有的 Survey123 调查列表。

获取附件

操作 ID:
GetAttachment

从特征层中的记录获取附件。

参数

名称 密钥 必需 类型 说明
中的层
 contentFilter True string

使用 ArcGIS 帐户登录时，可以搜索组织、组织的组或公共内容中的内容。
特征层
 userLayer True string

从 ArcGIS 内容中选择特征层
对象标识符
 objectid True number

与附件关联的记录的对象 ID
Attachment
 attachmentId True number

选择附件名称或输入附件 ID

返回

附件的内容。

附件内容
binary

获取项信息

操作 ID:
GetPortalItemInformation

获取项目信息返回特定组织项的信息。

参数

名称 密钥 必需 类型 说明
搜索项目标题
 searchTerm True string

输入要搜索的值，或输入 * 返回前 100 个项目。
Item
 item True string

选择项目或使用“标题”优化搜索。

返回

此操作输出是动态内容。

转换日期和时间格式

操作 ID:
TimeConversionHelper

在 Epoch Unix 时间戳和字符串格式之间进行转换。

参数

名称 密钥 必需 类型 说明
日期时间
 dateTime True string

Unix epoch 的时间（以秒或毫秒为单位或字符串）。

返回

名称 路径 类型 说明
字符串格式的日期和时间
 stringTime string

字符串格式的日期和时间
作为 Unix 时间戳的日期和时间（以秒为单位）
 unixTimeStampSeconds number

作为 Unix 时间戳的日期和时间（以秒为单位）
作为 Unix 时间戳的日期和时间（以毫秒为单位）
 unixTimeStampMilliseconds number

作为 Unix 时间戳的日期和时间（以毫秒为单位）

运行数据管道

操作 ID:
RunDataPipeline

运行一个数据管道，该管道可自动执行数据准备工作流，并使 ArcGIS 中的功能层保持最新。

参数

名称 密钥 必需 类型 说明
中的数据管道
 dataPipelineFilter True string

使用 ArcGIS 帐户登录时，可以搜索要运行的数据管道。
数据管道
 dataPipelineItem True string

从 ArcGIS 内容中选择数据管道
最大运行持续时间（分钟）
 timeoutInMinutes True number

数据管道在取消之前可以运行的最大时间

返回

Body
runResult

触发器

从特征层中删除记录时

此作在功能层中删除记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。
创建附件时

当在功能层中的记录中创建附件时，此作将触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。
删除附件时

此作在功能层中删除附件时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。
在特征层中创建记录时

此作在功能层中创建记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。
在特征层中更新记录时

此作在特征层中更新记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。
提交调查响应时

当用户提交调查响应时触发新流
更新附件时

此作在功能层中更新附件时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

从特征层中删除记录时

操作 ID:
WebhookFLDeleted

此作在功能层中删除记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

当前用户拥有的功能层。 此处列出的层已启用“修订”选项。

返回

此操作输出是动态内容。

创建附件时

操作 ID:
WebhookAttachmentCreated

当在功能层中的记录中创建附件时，此作将触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

已启用更改跟踪的用户拥有的功能层。

返回

此操作输出是动态内容。

删除附件时

操作 ID:
WebhookAttachmentDeleted

此作在功能层中删除附件时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

已启用更改跟踪的用户拥有的功能层。

返回

此操作输出是动态内容。

在特征层中创建记录时

操作 ID:
WebhookFLCreated

此作在功能层中创建记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

已启用更改跟踪的用户拥有的功能层。

返回

此操作输出是动态内容。

在特征层中更新记录时

操作 ID:
WebhookFLEdited

此作在特征层中更新记录时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

当前用户拥有的功能层。 此处列出的层已启用“修订”选项。

返回

此操作输出是动态内容。

提交调查响应时

操作 ID:
AddData

当用户提交调查响应时触发新流

参数

名称 密钥 必需 类型 说明
调查
 surveyId True string

从 ArcGIS 内容中选择调查
events
 events True array of string

events
包括门户信息
 includePortalInfo True boolean

在有效负载中包含门户信息，例如门户的 URL
包括用户信息
 includeUserInfo True boolean

在有效负载中包含用户信息，例如名称和电子邮件地址
包括调查信息
 includeSurveyInfo True boolean

在有效负载中包含调查信息，例如调查标题和 itemID
包括提交的记录
 includeServiceRequest True boolean

在有效负载中包含记录信息，例如特征的属性和几何图形
包括服务器响应
 includeServiceResponse True boolean

在有效负载中包含服务器响应

返回

此操作输出是动态内容。

更新附件时

操作 ID:
WebhookAttachmentUpdated

此作在功能层中更新附件时触发流。 必须将此触发器与“从功能层提取更新、更改或删除”作结合使用，才能检索有关对特征层的任何更改的信息。

参数

名称 密钥 必需 类型 说明
特征层
 userLayer True string

已启用更改跟踪的用户拥有的功能层。

返回

此操作输出是动态内容。

定义

runResult

名称 路径 类型 说明
appUrl
 appUrl string

用于查看运行结果的应用程序 URL。
runId
 runId string

运行 ID。
项目编号
 itemId string

数据管道项 ID。
状态
 status string

运行状态。

batchAddUpdateFeatures

名称 路径 类型 说明
错误计数
 errorCount number

错误计数
成功计数
 successCount number

成功计数
success
 result.success array of object
对象标识符
 result.success.objectId number

所创建记录的对象 ID
全局 ID
 result.success.globalId string

已创建记录的全局 ID
错误
 result.error array of object
对象标识符
 result.error.objectId number

所创建记录的对象 ID
全局 ID
 result.error.globalId string

已创建记录的全局 ID

二进制

这是基本数据类型“binary”。