注:
您必须登录到 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 Enterprise 和 ArcGIS 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 | 用于比较几何的拓扑空间关系运算符。 此参数的值可以为:
| 是 |
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 年人口普查数据库。 |
|
5yearincrements | “5 岁递增”数据集合包含 2023 年、2028 年和 2010 年的人口数,按 5 岁细分。 数据表包含总人口的年龄以及按性别的年龄。 此集合包含来自 Esri 2023/2028 年更新的人口统计数据库、美国社区调查 (ACS) 数据库和 2010 年人口普查数据库。 |
|
Age | 此数据集合包含用于数据金字塔信息图的男性和女性年龄范围数据。 此集合包含 Esri 2023 年更新的人口统计数据。 |
|
=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 时,您也可以自定义此设置。