Python ArcGIS geocode_from_items用法及代码示例

本文简要介绍 python 语言中 arcgis.geocoding.geocode_from_items 的用法。

用法:

arcgis.geocoding.geocode_from_items(input_data, output_type='Feature Layer', geocode_service_url=None, geocode_parameters=None, country=None, output_fields=None, header_rows_to_skip=1, output_name=None, category=None, context=None, gis=None)

返回：

Item 对象。

geocode_from_items 方法从 Item 或 Layer 对象创建 Geocoder 对象。

注意：

geocode_from_items 对整个文件进行地理编码，无论大小。

Parameter	Description
input_data	必填项、字符串、图层。要进行地理编码的数据。
output_type	可选字符串。导出项目类型。允许的值为 “CSV”、“XLS” 或 “FeatureLayer”。 注意： output_type 的默认值为 “FeatureLayer”。
geocode_service_url	地理编码器的可选字符串。可选的Geocoder，用于在空间上启用数据集。
geocode_parameters	可选字典。这包括帮助解析输入数据的参数，以及字段长度和字段映射。此值是指定用于地理编码的服务器上可用的analyze_geocode_input 的输出。在提交作业之前仔细检查字段映射并进行相应调整非常重要，否则您的地理编码结果可能不准确。建议使用analyze_geocode_input 的输出并修改字段映射，而不是手动构建此字典。 值 field_info - 三元组列表，包含输入数据的字段名称、字段类型(通常为 TEXT)和允许的长度(通常为 255)。 示例：[[‘ObjectID’, ‘TEXT’, 255], [‘地址’, ‘TEXT’, 255], [‘地区’, ‘TEXT’, 255], [‘邮政’, ‘TEXT’, 255]] header_row_exists - 输入真或假。 column_names - 如果您的数据没有标题行，请提交数据的列名。 field_mapping - 每个输入字段和地理编码服务上的候选字段之间的字段映射。示例：[[‘ObjectID’, ‘OBJECTID’], [‘Address’, ‘Address’], [‘Region’, ‘Region’], [‘Postal’, ‘Postal’]]
country	可选字符串。如果您的所有数据都在一个国家/地区，这有助于提高接受该变量的定位器的性能。
output_fields	可选字符串。输入您希望在结果中返回的地理编码服务的输出字段，以逗号分隔。要输出所有可用的输出字段，请将此参数留空。 示例：得分,match_addr,x,y
header_rows_to_skip	可选整数。说明您的数据从文件或表中的哪一行开始。默认值为 1(因为第一行包含标题)。默认值为 1。
output_name	可选字符串，任务将创建结果的要素服务。您定义服务的名称。
category	可选字符串。输入一个类别以获得更精确的地理编码结果(如果适用)。某些地理编码服务不支持类别，可用选项取决于您的地理编码服务。
context	可选字典。上下文包含影响任务执行的其他设置。批量地理编码有以下两种设置： Extent(范围)- 定义分析区域的边界框。仅分析 inputLayer 中与边界框相交的那些点。 输出空间参考 (outSR) - 将输出要素投影到输出空间参考中。 语法：{ “extent”: {extent} “outSR”: {空间参考} }
gis	可选 GIS ，运行此工具的 GIS 。 注意： 如果未指定，则使用活动的GIS。

例子：

# Usage Example
>>> fl_item = geocode_from_items(csv_item, output_type='Feature Layer',
                     geocode_parameters={"field_info": ['Addresses', 'TEXT', 255],
                                         "column_names": ["Addresses"],
                                         "field_mapping": ['Addresses', 'Address']
                                         },
                     output_name="address_file_matching",
                     gis=gis)
>>> type(fl_item)
<:class:`~arcgis.gis.Item`>