Skip To Content

ArcGIS for Excel 函数

注:

您必须登录到 ArcGIS 账户,才能使用 ArcGIS for Excel 函数。 如果您尚未登录,则当您将鼠标悬停在所选单元格左上角的绿色三角形上时,将显示登录错误。 在 Microsoft Windows Desktop 或 macOS 中,您还会看到一个黄色警告图标。

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

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

提示:

在单元格中编写函数时,可以通过选择列或行中的一个或多个特定单元格来使用单元格引用。 由此可确保数据完整性。 有关详细信息,请参阅 Microsoft 创建或更改单元格引用文章。

注:

地理编码、GeoEnrichment Service 和路径选择函数将消耗配额。 几何函数不会消耗配额。 当您请求的建议数量超过 15 时,SUGGESTADDRESS 函数将消耗配额。 帮助程序函数不会消耗配额。 将对您的 ArcGIS 函数进行缓存,以避免在刷新该函数时消耗额外配额。 此缓存会增加 Microsoft Excel 文件的大小。 要清除 ArcGIS for Excel 函数缓存,请单击设置窗格中的清除缓存按钮。

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

Excel 的单元格中运行某些 ArcGIS 函数时,这些函数可能会失败并显示服务不可用错误。 请联系您的组织管理员以启用该服务或获取详细信息。

有关服务的详细信息,请参阅 ArcGIS EnterpriseArcGIS Online 文档。

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

注:

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

GETCOORDINATES

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

语法

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

参数

参数描述必需参数

address

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

spatial reference

点位置的空间参考。 这可以是 WKID(数字)或 WKT(文本)。 请参阅有效 WKID 值的列表。 默认值为 4326 (WGS84)。

match_details

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

geocode_service

从下拉菜单中选择地理编码服务。 该服务将列出适用于组织成员的所有定位器。

注:

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

函数示例 1

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

结果

经度 (X)纬度 (Y)

-117.19479

34.057265

函数示例 2

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

结果

经度 (X)纬度 (Y)地址匹配得分地理定位器地址类型

-117.1948

34.057265

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

100

World

PointAddress

GETADDRESS

一个 Geocoding 函数。 通过反向地理编码确定特定经度-纬度位置的地址。

语法

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

参数

参数描述必需参数

longitude(X)

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

latitude(Y)

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

spatial reference

点位置的空间参考。 这可以是 WKID(数字)或 WKT(文本)。 请参阅有效 WKID 值的列表。 默认值为 4326 (WGS84)。

all_data

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

geocode_service

从下拉菜单中选择地理编码服务。 该服务将列出适用于组织成员的所有定位器。

函数示例 1

=ARCGIS.GETADDRESS(-70.251, 43.65808)

结果

地址

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

函数示例 2

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

结果

匹配的地址地址全称地址简称地址类型类型地名街号街道名称街区细分区域社区行政区城市大都市区子区域区域地区缩写区域邮政编码邮政编码扩展单个国家/地区国家/地区代码

Standard Baking

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

Standard Baking

POI

Bakery

Standard Baking

75

75 Commercial St.

Portland

Cumberland county

Maine

ME

04101

United States

USA

ENRICHBYPOINT

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

语法

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

参数

参数描述必需参数

longitude(X)

感兴趣点的经度。

latitude(Y)

感兴趣点的纬度。

spatial_reference

点位置的空间参考。 这可以是 WKID(数字)或 WKT(文本)。 请参阅有效 WKID 值的列表。 默认值为 4326 (WGS84)。

distance

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

unit

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

travel_mode

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

data_collections

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

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

analysis_variables

要从数据集合返回的变量,例如 KeyGlobalFacts.TOTPOP, AGE.MALE5。 如果留空,则将请求数据集合 KeyGlobalFacts 的所有变量。

运行 LISTDATACOLLECTIONS 函数以请求变量列表,或者查看数据采集查找器以查看变量列表。

include_derivative_variables

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

include_studyarea_details

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

函数示例 1

=ARCGIS.ENRICHBYPOINT(-90.491, 38.777)

结果

总人口总户数平均家庭人口数男性人口女性人口

11464

4860

1.98

5745

5719

注:

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

函数示例 2

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

结果

国家/地区代码区域类别缓冲区单位别名缓冲区半径2022 年医疗2022 年医疗:指数2022 年牙科服务2022 年牙科服务:指数

US

NetworkServiceArea

出行距离(英里)

5

240971277

99

15463985

99

ENRICHBYGEOGRAPHY

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

语法

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

analysis_variables

要从数据集合返回的变量,例如 KeyGlobalFacts.TOTPOP, AGE.MALE5。 如果留空,则将请求数据集合 KeyGlobalFacts 的所有变量。

运行 LISTDATACOLLECTIONS 函数以请求变量列表,或者查看数据采集查找器以查看变量列表。

include_derivative_variables

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

include_geography_details

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

函数示例 1

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

结果

总人口总户数平均家庭人口数男性人口女性人口

39770476

13570050

2.86

19767455

20003021

函数示例 2

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

结果

2020 年家庭总收入(按年)2020 年家庭平均收入(按年)2020 年家庭平均收入(按月)2020 年年度平均收入(按人口)2020 年月度平均收入(按人口)

1.99E + 10

29898.9

2491.57

11938.06

994.84

注:

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

函数示例 3

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

结果

平均家庭人口数2020 年家庭平均收入(按年)

2.5

29898.9

函数示例 4

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

结果

标准地理级别标准地理名称标准地理 ID国家/地区代码2022 年医疗2022 年医疗:指数2022 年牙科服务2022 年牙科服务:指数

美国各州

加利福尼州

06

US

1.08894E+11

113

7.37E+09

119

ENRICHBYADDRESS

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

语法

ARCGIS.ENRICHBYADDRESS(address, [distance], [unit],[travel_mode],[data_collections],[variables],[include_derivative_variables], [include_studyarea_details])

参数

参数描述必需参数

address

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

distance

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

unit

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

travel_mode

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

analysis_variables

要从数据集合返回的变量,例如 KeyGlobalFacts.TOTPOP, AGE.MALE5。 如果留空,则将请求数据集合 KeyGlobalFacts 的所有变量。

运行 LISTDATACOLLECTIONS 函数以请求变量列表,或者查看数据采集查找器以查看变量列表。

include_derivative_variables

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

include_studyarea_details

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

函数示例 1

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

结果

总人口总户数平均家庭人口数男性人口女性人口

11464

4860

1.98

5745

5719

注:

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

函数示例 2

=ARCGIS.ENRICHBYADDRESS("380 New York Street, Redlands, CA, USA", 5, "miles", "driving", "health", "X8001_X, X8021_X", "index", TRUE)

结果

国家/地区代码区域类别缓冲区单位别名缓冲区半径2022 年医疗2022 年医疗:指数2022 年牙科服务2022 年牙科服务:指数

US

NetworkServiceArea

出行距离(英里)

5

240971277

99

15463985

99

ENRICHBYPOLYGON

一个 GeoEnrichment 函数。 获取特定区域内的人口、地点和商业信息。

语法

ARCGIS.ENRICHBYPOLYGON (esrijson_polygon, analysis_variables, include_derivative_variables)

参数

参数描述必需参数

esrijson_polygon

一个以 EsriJSON 几何格式表示的面,用于表示要获取人口统计信息的区域。

analysis_variables

要从数据集合返回的变量,例如 KeyGlobalFacts.TOTPOP, AGE.MALE5。 如果留空,则将请求数据集合 KeyGlobalFacts 的所有变量。

运行 LISTDATACOLLECTIONS 函数以请求变量列表,或者查看数据采集查找器以查看变量列表。

include_derivative_variables

输出必须包含导数变量。 参数值可以为百分比、指数、平均值或全部。 如果留空,则不包括导数变量。

FINDROUTE

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

语法

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

函数示例 1

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

结果

出行距离(英里)出行时间(分钟)路径形状

391.3764

401.6001295

{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-77.244918653,38.92906864],[-77.2443203,38.9292242], ...

注:

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

函数示例 2

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

结果

描述出行距离(英里)出行时间(分钟)路径形状

总出行距离/时间

382.7767

408.1581

起点为位置 1

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24491862136172,38.92906862347136]]]}

向东行驶

0.03108

0.300162

{"spatialReference":{"wkid":4326},"paths":[[[-77.24491862136172,38.92906862347136],[-77.24432026092327,38.92922419358836],[-77.2431644738714,38.92953551367221],[-77.24291516601454,38.92957141170151],[-77.24263625487299,38.92926048728733]]]}

左转,然后在 Leesburg Pike 右转

0.422316089

1.215881348

{"spatialReference":{"wkid":4326},"paths":[[[-77.24263627476374,38.929260492606396],[-77.24232884852634,38.92937681604757], ...

终点为位置 2 左侧

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-80.78293244317324,35.10024066538108],[-80.78293244317324,35.10024066538108]]]}

FINDROUTEBYADDRESS

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

语法

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

参数

参数描述必需参数

from_address

路径起始位置的地址。

to_address

路径目的地位置的地址。

travel_mode

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

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

unit

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

include_directions

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

函数示例 1

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

结果

出行距离(英里)出行时间(分钟)路径形状

14.32662

20.73435

{"spatialReference":{"latestWkid":4326,"wkid":4326},"paths":[[[-117.194789317,34.057516991],[-117.1940741,34.057515], ...

函数示例 2

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

结果

描述出行距离(公里)出行时间(分钟)路径形状

总出行距离/时间

22.9899

22.40177

起点为位置 1

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19478927505831,34.057516969635486]]]}

向东行驶

0.0660270315239986

0.396162189143992

{"spatialReference":{"wkid":4326},"paths":[[[-117.19478927505831,34.057516969635486],[-117.19407404027919,34.057515005004625]]]}

左转

0.0665435791015625

0.3992919921875

{"spatialReference":{"wkid":4326},"paths":[[[-117.19407405467044,34.057514980900905],[-117.19406685106797,34.05811489909636]]]}

终点为位置 2 左侧

0

0

{"spatialReference":{"wkid":4326},"paths":[[[-117.37829693421398,33.97863201286705],[-117.37829693421398,33.97863201286705]]]}

VERTICESTOESRIJSON

一个 Geometry 函数。 从折点坐标列表创建 EsriJSON 折线或面几何。

语法

ARCGIS.VERTICESTOESRIJSON(xy_vertices、spatial_reference、geometry_type、y_then_x)

参数

参数描述必需参数

xy_vertices

包含折点坐标的单元格范围。 折点可以按行或列格式指定。

spatial_reference

点位置的空间参考。 这可以是 WKID(数字)或 WKT(文本)。 请参阅有效 WKID 值的列表。 默认值为 4326 (WGS84)。

geometry_type

几何类型。 参数值可以为折线或面。 默认值为面。

y_then_x

如果设置为 TRUE,则表示坐标先指定纬度 (Y) 再指定经度 (X)。 默认值为 FALSE,即坐标顺序采用先 X 后 Y 的顺序。

CONVERTTOESRIJSON

一个 Geometry 函数。 将非 Esri 格式的几何转换为 EsriJSON 几何。

语法

ARCGIS.CONVERTTOESRIJSON (geometry_to_convert)

参数

参数描述必需参数

geometry_to_convert

要转换为 EsriJSON 的几何。 这可以是 WKT 或 GeoJSON 几何。

GETPOLYGONAREA

一个 Geometry 函数。 用于计算多边形的面积。

语法

ARCGIS.GETPOLYGONAREA(esrijson_polygon, unit, measurement_type)

参数

参数描述必需参数

Esrijson_geometry

Esri JSON 几何。

单位

distance 参数的测量单位。 可以为平方毫米、平方分米、平方米、平方千米、平方英寸、平方英尺、平方码、平方英里、美国平方英尺、英亩或公顷。 如果设置了 travel_mode 参数,也可以是秒、分钟或小时。 默认值为 miles

Measurement_type

用于确定距离的测量类型。 参数值可以为:

  • 平面
  • 测地线
  • 等角航线
  • 大椭圆

默认值为测地线。

GETGEOMETRYLENGTH

一个 Geometry 函数。 用于计算几何的长度。

语法

=ARCGIS.GETGEOMETRYLENGTH(esrijson_geometry, unit, measurement_type)

参数

参数描述必需参数

Esrijson_geometry

Esri JSON 几何。

单位

distance 参数的测量单位。 可以为厘米、分米、米、千米、英寸、英尺、码、英里、美国英尺或海里。 默认值为 miles

Measurement_type

用于确定距离的测量类型。 参数值可以为:

  • 平面
  • 测地线
  • 等角航线
  • 大椭圆

默认值为测地线。

GETGEOMETRYDISTANCE

一个 Geometry 函数。 用于计算两个几何之间的距离。

语法

=ARCGIS.GETGEOMETRYDISTANCE(esrijson_geometry1, esrijson_geometry2, unit, measurement_type)

参数

参数描述必需参数

Esrijson_geometry1

第一个 Esri JSON 几何。

Esrijson_geometry2

第二个 Esri JSON 几何。

单位

distance 参数的测量单位。 可以为厘米、分米、米、千米、英尺、码、英里、美国英尺或海里。 默认值为 miles

Measurement_type

用于确定距离的测量类型。 参数值可以为:

  • 平面
  • 测地线
  • 等角航线
  • 大椭圆

默认值为测地线。

GETCENTROID

一个 Geometry 函数。 用于计算几何的质心。

语法

=ARCGIS.GETCENTROID(esrijson_geometry)

参数

参数描述必需参数

Esrijson_geometry

一个 Esri JSON 几何。

RELATEGEOMETRIES

一个 Geometry 函数。 通过执行空间关系操作将几何与另一个几何进行比较。

语法

=ARCGIS.RELATEGEOMETRIES(esrijson_geometry_or_XY1, topologocal_operation, esrijson_geometry_or_XY2)

参数

名称描述必需参数

esrijson_geometry_or_XY1

要比较的点的 Esri JSON 几何或坐标。

topologocal_operation

用于比较几何的拓扑空间关系运算符。 此参数的值可以为:

  • 包含
  • 交叉
  • Equals
  • 相交
  • Touches
  • 重叠

esrijson_geometry_or_XY2

要进行比较的点的 Esri JSON 几何或坐标。

GENERALIZEGEOMETRY

一个 Geometry 函数。 使用道格拉斯-普克算法概化几何。

语法

=ArcGIS.GENERALIZEGEOMETRY(esrijson_geometry, max_deviation, max_deviation_unit, remove_degenerate_parts)

参数

参数描述必需参数

Esrijson_geometry

Esri JSON 几何。

Max_deviation

允许的概化几何与原始几何的最大偏差。 如果 maxDeviation 等于或小于零,则运算符返回输入几何。

Max_deviation_unit

最大允许偏差的长度单位。 如果针对“地理坐标系”设置此值,则会发生错误。 如果未设置该值,则使用几何的空间参考单位。

Remove_degenerate_parts

当设置为 TRUE 时,将从输出中移除概化几何中维度低于输入的任何部分(例如概化为线的多边形)。 默认值为 FALSE。

SUGGESTADDRESS

一个 Helper 函数。 根据文本输入建议地址。 可用作交互式自动完成地址搜索。

语法

ARCGIS.SUGGESTADDRESS(search_term, [max_suggestions], [country], [geocode_service])

参数

参数描述必需参数

search_term

用户提供的输入文本,用于生成可能匹配的列表。

max_suggestions

要返回的最大建议数。 如果这个数字大于 15,将通过地理编码操作提出建议,并且可能消耗更多的配额并生成意外结果。 默认值为 5。 最大值为 50。

country

将结果限制在特定国家/地区。 例如,使用 United Kingdom。 运行 ARCGIS.LISTGEOGRAPHIES 可请求国家/地区列表。

geocode_service

要返回的最大建议数。 如果这个数字大于 15,将通过地理编码操作提出建议,并且可能消耗更多的配额并生成不同的结果。 默认值为 5。 最大值为 50。

函数示例

=ARCGIS.SUGGESTADDRESS("Orange county",10, "USA")

结果

Orange County, CA, USA

Orange County, FL, USA

Orange County, IN, USA

Orange County, NC, USA

Orange County, NY, USA

Orange County, TX, USA

Orange County, VA, USA

Orange County, VT, USA

Orange County Great Park, Irvine, CA, USA

Orange County Airport, 500 Dunn Rd, Montgomery, NY, 12549, USA

GETGEOMETRY

一个 Helper 函数。 获取特定地理区域,包括其区域 ID 和几何。

语法

ARCGIS.GETGEOMETRY (country, geography_level_id, search_term, exact_match, show_all_matches)

参数

参数描述必需参数

country

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

geography_level_id

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

search_term

地理区域名称,用作搜索关键词。 例如,使用 California, San Diego, CA。

exact_match

仅返回与您的搜索词完全匹配的结果。

show_all_matches

如果有匹配项具有多个地理区域,返回包含搜索词的所有结果。

LISTGEOGRAPHIES

一个 Helper 函数。 根据输入参数,返回国家/地区列表、国家/地区的地理级别列表(例如区或省)或地理级别的区域 ID 列表。 最大限制为 5000 个列表项。

语法

ARCGIS.LISTGEOGRAPHIES([country], [geography_level_id], [search_term], [exact_match])

参数

参数描述必需参数

country

数据集合的来源国家/地区。 例如,使用 United Kingdom。 如果指定了一个值,则将列出该国家/地区的所有地理级别。 如果留空,则列出所有国家和地区。

geography_level_id

地理级别的 ID。 例如,使用 US.States 表示美国各州。 如果指定了一个值,则会列出地理级别的所有区域(例如 California)及其 FIPS ID。 如果留空,结果将取决于 country 参数。

search_term

搜索词,通过将搜索词与地理名称进行匹配来缩小结果范围。

exact_match

仅返回与您的搜索词完全匹配的结果。

函数示例

=ARCGIS.LISTGEOGRAPHIES()

结果

单个国家/地区国家/地区代码

阿尔巴尼亚

AL

阿尔及利亚

DZ

安道尔

AD

安哥拉

AO

安圭拉

AI

=ARCGIS.LISTGEOGRAPHIES("USA")

结果

ID名称

US.WholeUSA

整个国家/地区

US.States

US.DMA

DMAs

US.CD

国会选区

US.CBSA

CBSAs

US.Counties

US.CSD

县细分区

US.ZIP5

邮政编码

US.Places

城市和城镇(地点)

US.Tracts

人口普查区域

US.BlockGroups

区块组

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities")

结果

ID名称主要地理细分

01001

Alegría-Dulantzi

巴斯克

01002

Amurrio

巴斯克

01003

Aramaio

巴斯克

01004

Artziniega

巴斯克

01006

Armiñón

巴斯克

=ARCGIS.LISTGEOGRAPHIES("Spain","ES.Municipalities","Barcelona")

ID名称主要地理细分

08019

巴塞罗那

Cataluña

LISTDATACOLLECTIONS

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

语法

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

参数

参数描述必需参数

country

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

data_collection_id

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

search_term

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

函数示例

=ARCGIS.LISTDATACOLLECTIONS("USA")

结果

ID描述数据示例

1yearincrements

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

  • 2023 年年龄小于 1 的人口
  • 2023 年年龄为 10 的人口
  • 2023 年年龄为 35 的人口

5yearincrements

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

  • 2023 年年龄为 0-4 的人口
  • 2023 年年龄为 25-29 的人口
  • 2023 年年龄为 40-44 的人口

Age

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

  • 2023 年年龄为 0-4 的男性
  • 2023 年年龄为 5-9 的女性
  • 2023 年年龄为 60-64 的男性

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

结果

ID名称描述

REL65HI2OC

2023 年龄超过 65 岁的人口:其他健康保险组合 REL(ACS 5 年)

2023 年龄超过 65 岁的人口:其他健康保险组合 REL(ACS 5 年)

ACSCIVNINS

2023 年非社会福利机构收容居民人口(ACS 5 年)

2023 年非社会福利机构收容居民人口(ACS 5 年)

MOECIVNINS

2023 年非社会福利机构收容居民人口 MOE(ACS 5 年)

2023 年非社会福利机构收容居民人口 MOE(ACS 5 年)

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

结果

ID名称描述

ACSCIVNI0

2023 年年龄低于 19 岁的非社会福利机构收容居民人口(ACS 5 年)

2023 年年龄低于 19 岁的非社会福利机构收容居民人口(ACS 5 年)

ACS0ONEHI

2023 年年龄低于 19 岁的人口:1 种健康保险(ACS 5 年)

2023 年年龄低于 19 岁的人口:1 种健康保险(ACS 5 年)

MOE0ONEHI

2023 年年龄低于 19 岁的人口:1 种健康保险 MOE(ACS 5 年)

2023 年年龄低于 19 岁的人口:1 种健康保险 MOE(ACS 5 年)

注:

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

LISTTRAVELMODES

一个 Helper 函数。 列出 ArcGIS Online 支持或为您的组织配置的路径服务的所有出行模式。

注:

此函数不需要参数。 有关相似示例,请参见 Microsoft RAND 函数文章。

语法

ARCGIS.LISTTRAVELMODES()

函数示例

=ARCGIS.LISTTRAVELMODES()

名称描述细节

行驶时间

对车辆和其他类似小型汽车(例如小卡车)的移动进行建模,寻找能够优化出行时间的解决方案。 遵守单行道规则,避免违章转弯并遵守特定于汽车的其他规则。 如果指定起始时间,则在适用的情况下,将采用基于交通状况的动态行驶速度。

避开拼车道路;快车道;避开关口;避开私家道路;避开未铺砌道路;驾驶汽车;禁止在建道路;禁止过境交通;最高车速 (km/h):出行时间 0

步行时间

沿着允许行人通过的线路和道路,寻找能够优化出行时间的解决方案。 步行速度设置为 5 公里/小时。

避开私家道路;避开不适合行人的道路;行人首选;步行速度 (km/h):步行时间 5;步行

步行距离

沿着允许行人通过的路径和道路行驶,然后找到优化行驶距离的解决方案。

避开私家道路;避开不适合行人的道路;行人首选;步行速度 (km/h):步行时间 5;步行

注:

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

ADDHEADERS

ArcGIS for Excel 函数的输出创建标头行。 此函数不适用于某些函数,例如 Helper 函数类别下的一些函数。

注:

此函数只需一个参数。

注:

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

语法

ARCGIS.ADDHEADERS(ARCGIS_function)

参数

参数描述必需参数

ARCGIS_function

输入要添加标题的另一个 ArcGIS for Excel 函数的单元格引用。

函数示例

=ARCGIS.ADDHEADERS(A2)

如果单元格 A2 中存在另一个函数,则此示例适用。 例如,如果单元格 A2 包含 =ARCGIS.GETCOORDINATES("380 New York Street, Redlands, CA, USA") 函数。

结果

经度 (X)

纬度 (Y)

逗号、小数点和分号分隔符

如果您使用的是德语、荷兰语、西班牙语、法语或意大利语操作系统,则以十进制形式写入的数字的格式可能与使用英语操作系统的数字不同。 对于某些语言,将使用逗号 (,),而非小数点 (.) 来写入或分隔包含小数的数字。

根据小数分隔符的不同,Excel 中的函数格式可能会有所不同。

  • 如果使用小数点 (.) 分隔符,则必须必须使用逗号 (,) 来分隔函数参数输入,例如,=ARCGIS.GETADDRESS(-70.251, 43.65808)
  • 如果使用逗号 (,) 小数分隔符,则必须使用分号 (;) 来分隔函数参数输入,例如,=ARCGIS.GETADDRESS(-70,251; 43,65808)

Excel 中,默认的小数分隔符与您的操作系统相同。 当使用 Excel 时,您也可以自定义此设置