您必须登录到 ArcGIS 帐户，才能使用 ArcGIS for Excel 函数。

Microsoft Excel 包含一组函数或公式，您可以使用这些函数或公式来计算信息，范围涵盖简单的算术求和到复杂的单元格填充。

ArcGIS for Excel 包括可用于地理编码、数据丰富和执行路径操作的相似函数。 每个函数在单元格中都以等号 (=) 开头，后跟函数名称及其输入参数（如果有），并用括号括起来。

有关如何设置 ArcGIS for Excel 地图，请参阅 ArcGIS for Excel入门。

在单元格中编写函数时，可以通过选择列或行中的一个或多个特定单元格来使用单元格引用。 该函数将使用指定函数自动填充一个或多个所选单元格，并且可能覆盖现有数据。 由此可确保数据完整性。 有关详细信息，请参阅 Microsoft 创建或更改单元格引用文章。

地理编码、GeoEnrichment 和路径选择函数将消耗配额。 当您请求的建议数量超过 15 时，SUGGESTADDRESS 函数将消耗配额。 帮助程序函数不会消耗配额。 要清除 ArcGIS for Excel 函数缓存，请单击设置窗格中的清除缓存按钮。

您可以将本主题中的示例复制到 Excel 工作表中，以可视化函数的工作原理。 您还可以使用函数构建器工具中的 ArcGIS for Excel 函数。

以下部分介绍了 ArcGIS for Excel 函数并包括语法、示例和参数说明。

在以下函数示例中，函数的实际结果不包含标头。 运行 ADDHEADERS 函数可请求标头。

通过反向地理编码确定特定经度/纬度位置的地址。

ARCGIS.GETADDRESS(longitude(X), latitude(Y), [spatial_reference], [all_data])

longitude(X)

用于搜索最近地址的点的经度。

是

latitude(Y)

用于搜索最近地址的点的纬度

是

空间参考

点位置的空间参考。 这可以是 WKID（数字）或 WKT（文本）。

有关 WKID 有效值列表，请参见投影坐标系和地理坐标系。 默认值为 4326 (WGS84)。

否

all_data

如果设置为 TRUE，则不仅返回反向地理编码的地址名称，还将返回所有地址属性，例如“城市”或“区域”。 默认为 FALSE。

否

=ARCGIS.GETADDRESS(-70.251, 43.65808)

结果

Standard Baking, 75 Commercial St, Portland, ME, 04101, USA

=ARCGIS.GETADDRESS(-70.251, 43.65808, 4326, TRUE)

结果

Standard Baking

Standard Baking, 75 Commercial St, Portland, ME, 04101, USA

Standard Baking

POI

面包店

Standard Baking

75

75 Commercial St.

波特兰

Cumberland county

缅因州

ME

04101

美国

USA

对位置进行地理编码。 此函数可返回可能的位置，包括经度、纬度，以及匹配地址和匹配得分(可选)。

ARCGIS.GETCOORDINATES(address, [spatial_reference], [match_details])

address

要进行地理编码的位置。 可以是街道地址、地名、邮政编码或 POI。

是

空间参考

点位置的空间参考。 这可以是 WKID（数字）或 WKT（文本）。

有关 WKID 有效值列表，请参见投影坐标系和地理坐标系。 默认值为 4326 (WGS84)。

否

match_details

如果设置为 TRUE，则不仅返回经度和纬度，还将返回匹配点的地址名称和匹配得分。 默认为 FALSE。

否

在所有函数示例中，函数的实际结果均不包含标头。 运行 ADDHEADERS 函数可请求标头。

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA")

结果

-117.19479

34.057265

=ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA", 4326 , TRUE)

结果

-117.1948

34.057265

380 New York St, Redlands, CA, 92373, USA

100

世界

PointAddress

获取有关地图的特定命名行政边界或地理级别(例如区、州和邮政编码)中的人员、地点和企业的信息。

ARCGIS.ENRICHBYGEOGRAPHY(area_id, geography_level_id, [data_collections], [variables], [include_derivative_variables], [include_geography_details])

area_id

要获取人口统计信息的区域的 FIPS ID。 运行 LISTGEOGRAPHIES 函数可请求特定地理级别的区域 ID 列表。 例如，"06" 为加利福尼亚州。

是

geography_level_id

区域 ID 所属的地理级别的 ID。 运行 LISTGEOGRAPHIES 函数可请求特定地理级别的区域 ID 列表，或检查此处的地理级别列表。 例如，"US.States" 为美国的州。

是

data_collections

将用于丰富输入要素的预组属性列表。

运行 LISTDATACOLLECTIONS 函数可请求数据集合列表。 示例为 "KeyUSFacts, KeyGlobalFacts"。 默认设置为 KeyGlobalFacts。

否

variables

要从数据集合返回的一部分变量。 运行 LISTDATACOLLECTIONS 函数以请求变量列表，或查看数据集合。 示例为 KeyGlobalFacts.TOTPOP, AGE.MALE5。 如果留空，则将请求数据集合的所有变量。

否

include_derivative_variables

要包含在输出中的导数变量。 这可以是百分比、指数、平均值或全部。 如果留空，则不包括导数变量。

否

include_geography_details

如果设置为 TRUE，则将包括相关的地理详细信息，例如国家/地区代码、地理级别和区域 ID。 默认为 FALSE。

否

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States")

结果

39770476

13570050

2.86

19767455

20003021

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", "IncomeTotalsAIS")

结果

1.99E + 10

29898.9

2491.57

11938.06

994.84

在所有函数示例中，函数的实际结果均不包含标头。 运行 ADDHEADERS 函数可请求标头。

=ARCGIS.ENRICHBYGEOGRAPHY("08019","ES.Municipalities", , "KeyGlobalFacts.AVGHHSZ, IncomeTotalsAIS.NINCHA")

结果

2.5

29898.9

=ARCGIS.ENRICHBYGEOGRAPHY("06","US.States","health", "X8001_X, X8021_X", "index", TRUE)

结果

美国各州

加利福尼州

06

代金券

1.08894E+11

113

7.37E+09

119

获取有关特定区域或某位置特定距离或行驶时间内的人员、地点和企业的丰富人口统计信息。 默认距离为点的一英里半径范围内。

ARCGIS.ENRICHBYPOINT(longitude(X), latitude(Y), [spatial_reference], [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_point_details])

longitude(X)

感兴趣点的经度。

是

latitude(Y)

感兴趣点的纬度。

是

spatial_reference

点位置的空间参考。 这可以是 WKID（数字）或 WKT（文本）。

有关 WKID 有效值列表，请参见投影坐标系和地理坐标系。 默认值为 4326 (WGS84)。

否

距离

半径或距离点的距离，将用于计算人口统计数据的环形缓冲区。 例如，使用 3 表示 3 英里半径。 默认值为 1。

否

unit

distance 参数的测量单位。 这可以是米、千米、英尺、码、英里或海里。 如果设置了 travel_mode 参数，也可以是秒、分钟或小时。 默认为 miles。

否

travel_mode

如果对此进行了设置，则将使用距兴趣点的行进距离来计算面积。 这可以是步行、驾驶或卡车运输。 如果留空，则将计算环形缓冲区面积。

否

data_collections

将用于丰富输入要素的预组属性列表。

运行 LISTDATACOLLECTIONS 函数可请求数据集合列表。 例如，可以使用 KeyUSFacts, KeyGlobalFacts。 默认设置为 KeyGlobalFacts。

否

variables

要从数据集合返回的一部分变量。 运行 LISTDATACOLLECTIONS 函数以请求变量列表，或查看数据集合。 示例为 "KeyGlobalFacts, TOTPOP, AGE.MALE5"。 如果留空，则将请求数据集合的所有变量。

否

include_derivative_variables

要包含在输出中的导数变量。 这可以是百分比、指数、平均值或全部。 如果留空，则不包括导数变量。

否

include_point_details

如果设置为 TRUE，则将包含相关点的详细信息，例如用于计算点周围相关区域的半径和距离测量方法。 默认为 FALSE。

否

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777)

结果

11464

4860

1.98

5745

5719

在所有函数示例中，函数的实际结果均不包含标头。 运行 ADDHEADERS 函数可请求标头。

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777, 4326, 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

结果

代金券

NetworkServiceArea

出行距离（英里）

5

240971277

99

15463985

99

使用找到的最佳路径查找两个位置之间的总出行距离（默认测量单位为英里）和时间（以分钟为单位）。

ARCGIS.FINDROUTE(from_longitude(X), from_latitude(Y), to_longitude(X), to_latitude(Y), [spatial_reference], [travel_mode], [unit], [include_directions])

from_longitude(X)

路径起始位置的经度坐标。

是

from_latitude(Y)

路径起始位置的纬度坐标。

是

to_longitude(X)

路径目的地位置的经度坐标。

是

to_latitude(Y)

路径目的地位置的纬度坐标。

是

spatial_reference

点位置的空间参考。 这可以是 WKID（数字）或 WKT（文本）。

有关 WKID 有效值列表，请参见投影坐标系和地理坐标系。 默认值为 4326 (WGS84)。

否

travel_mode

路径的出行模式。 使用出行模式（例如，步行、行驶或货运）计算区域，而不是环形缓冲区。

例如，使用“行驶距离”或“步行时间”。 运行 LISTTRAVELMODES 函数可请求受支持的出行模式列表。 如果留空，则将使用 ArcGIS 组织设置中指定的默认出行模式。 有关出行模式和参数的详细信息，请参阅配置出行模式。

否

unit

用于出行距离的测量单位。 这可以是英里、公里、米、英尺、点、码或海里。 默认值为英里。

否

include_directions

如果设置为 TRUE，则结果中将包括到目的地的路径方向，以及各步长行进的时间和距离。 默认为 FALSE。

否

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845)

结果

391.3764

401.6001295

在所有函数示例中，函数的实际结果均不包含标头。 运行 ADDHEADERS 函数可请求标头。

=ARCGIS.FINDROUTE(-77.24488778, 38.92894278, -80.78300851, 35.1001845, 4326, "Driving Distance", "miles", TRUE)

结果

总出行距离/时间

382.7767

408.1581

起点为位置 1

0

0

向东行驶

0.03108

0.300162

在 Springbank Ln 右转

0.087211

0.421049

终点为位置 2 左侧

0

0

使用找到的最佳路径查找两个地址之间的总出行距离（默认测量单位为英里）和时间（以分钟为单位）。

ARCGIS.FINDROUTEBYADDRESS(from_address, to_address, [travel_mode], [unit], [include_directions])

from_address

路径起始位置的地址。

是

to_address

路径目的地位置的地址。

是

travel_mode

路径的出行模式。 使用出行模式（例如，步行、行驶或货运）计算区域，而不是环形缓冲区。

例如，使用“行驶距离”或“步行时间”。 运行 LISTTRAVELMODES 函数可请求受支持的出行模式列表。 如果留空，则将使用 ArcGIS 组织设置中指定的默认出行模式。 有关出行模式和参数的详细信息，请参阅配置出行模式。

否

unit

用于出行距离的测量单位。 这可以是英里、公里、米、英尺、码或海里。 默认值为英里。

否

include_directions

如果设置为 TRUE，则结果中将包括到目的地的路径方向，以及各步长行进的时间和距离。 默认为 FALSE。

否

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside")

结果

14.32662

20.73435

=ARCGIS.FINDROUTEBYADDRESS("380 New York Street Redlands CA", "Downtown Riverside", "Driving Distance", "kilometers", TRUE)

结果

总出行距离/时间

22.9899

22.40177

起点为位置 1

0

0

向西南行驶

0.092545

0.555303

在交通信号灯处，在 University Ave 右转

0.427128

0.672165

终点为位置 2 左侧

0

0

列出一个国家/地区可用的数据集合。

ARCGIS.LISTDATACOLLECTIONS(country, [data_collection_id], [search_term])

country

数据集合的来源国家/地区。 例如，使用 United Kingdom。 运行 LISTGEOGRAPHIES 函数可请求国家/地区列表。

是

data_collection_id

数据集合的 ID。 例如，使用 KeyFacts。 如果指定了一个值，则将列出该数据集合的所有变量。 如果留空，则将列出指定国家/地区的所有数据集合。

否

search_term

搜索词，通过将搜索词与数据集合名称和描述或变量名称和描述进行匹配来缩小结果范围。 例如，使用 fast food。

否

=ARCGIS.LISTDATACOLLECTIONS("USA")

结果

1yearincrements

“1 岁递增”数据集合包含 2022 年和 2027 年年龄不超过 84 岁的人口数，按 1 岁细分。 该集合还包含 2010 年年龄不超过 21 岁的人口，按 1 岁递增。 数据表包含总人口的年龄以及按性别的年龄。 此集合包含来自 Esri 2022/2027 年更新的人口统计数据库和 Esri 2010 年人口普查数据库。

2022 年年龄小于 1 岁的人口、2022 年年龄为 1 岁的人口、2022 年年龄为 2 岁的人口

5yearincrements

“5 岁递增”数据集合包含 2022 年、2027 年和 2010 年的人口数，按 5 岁细分。 数据表包含总人口的年龄以及按性别的年龄。 此集合包含来自 Esri 2022/2027 年更新的人口统计数据库、美国社区调查 (ACS) 数据库和 2010 年人口普查数据库。

2022 年年龄为 0-4 岁的人口、2022 年年龄为 5-9 岁的人口、2022 年年龄为 10-14 岁的人口

年龄

此数据集合包含用于数据金字塔信息图的男性和女性年龄范围数据。 此集合包含 Esri 2022 年更新的人口统计数据。

=ARCGIS.LISTDATACOLLECTIONS("USA","health")

结果

REL65HI2OC

2020 年龄超过 65 岁的人口：其他健康保险组合 REL（ACS 5 年）

2020 年龄超过 65 岁的人口：其他健康保险组合 REL（ACS 5 年）

ACSCIVNINS

2020 年非社会福利机构收容居民人口（ACS 5 年）

2020 年非社会福利机构收容居民人口（ACS 5 年）

MOECIVNINS

2020 年非社会福利机构收容居民人口 MOE（ACS 5 年）

2020 年非社会福利机构收容居民人口 MOE（ACS 5 年）

=ARCGIS.LISTDATACOLLECTIONS("USA", "health", "