Python ArcGIS geocode_locations用法及代码示例

本文简要介绍 python 语言中 arcgis.geoanalytics.find_locations.geocode_locations 的用法。

用法:

arcgis.geoanalytics.find_locations.geocode_locations(input_layer, country=None, category=None, include_attributes=True, locator_parameters=None, output_name=None, geocode_service=None, geocode_parameters=None, gis=None, context=None, future=False)

返回：

FeatureLayer

geocode_locations 任务对来自大数据文件共享的表进行地理编码。该任务使用通过您的门户配置的地理编码实用程序服务。如果您没有配置地理编码实用程序服务，请与您的管理员联系。 Learn more about configuring a locator service 。

准备使用地理编码位置任务时，请务必查看使用 GeoAnalytics 服务器进行地理编码的最佳实践.

Parameter	Description
input_layer	必需的层。将被地理编码的表格输入。请参阅特征输入。
country	可选字符串。如果您的所有数据都在一个国家/地区，这有助于提高接受该变量的定位器的性能。
category	可选字符串。输入一个类别以获得更精确的地理编码结果(如果适用)。某些地理编码服务不支持类别，可用选项取决于您的地理编码服务。
include_attributes	可选的布尔值。一个布尔值，用于在结果中从地理编码服务返回输出字段。要输出所有可用的输出字段，请将此值设置为“True”。将该值设置为 false 将返回您的原始数据和地理编码坐标。某些地理编码服务不支持输出字段，可用选项取决于您的地理编码服务。
locator_parameters	可选字典。特定于您的定位器的附加参数。
output_name	可选字符串。该任务将创建结果的要素服务。您定义服务的名称。
geocode_service	可选字符串或地理编码器。您要对其地址进行地理编码的地理编码服务的 URL。 URL 必须以 geocodeServer 结尾并允许批量请求。地理编码服务必须配置为允许批量地理编码。有关详细信息，请参阅Configuring batch geocoding
geocode_parameters	可选字典。这包括帮助解析输入数据的参数，以及字段长度和字段映射。该值是您的服务器上指定用于地理编码的AnalyzeGeocodeInput 工具的输出。在提交作业之前仔细检查字段映射并进行相应调整非常重要，否则您的地理编码结果可能不准确。建议使用AnalyzeGeocodeInput 的输出并修改字段映射，而不是手动构建此 JSON。 值： field_info - A list of triples with the field names of your input data, the field type (usually TEXT), and the allowed length (usually 255) header_row_exists - Enter True or False. column_names - Submit the column names of your data if your data does not have a header row field_mapping - Field mapping between each input field and candidate fields on the geocoding service # Example >>> geocode_parameters = {field_info: [['ObjectID', 'TEXT', 255], ['Address', 'TEXT', 255], ['Region', 'TEXT', 255], ['Postal', 'TEXT', 255]], header_row_exists - True, field_mapping: [['ObjectID', 'OBJECTID'], ['Address', 'Address'], ['Region', 'Region'], ['Postal', 'Postal']] }
gis	可选的地理信息系统。运行此工具的 GIS。如果未指定，则使用活动 GIS。
context	可选字典。上下文包含影响任务执行的其他设置。对于此任务，有三个设置： processSR - The features will be projected into this coordinate system for analysis. outSR - The features will be projected into this coordinate system after the analysis to be saved. The output spatial reference for the spatiotemporal big data store is always WGS84. dataStore - Results will be saved to the specified data store. For ArcGIS Enterprise, the default is the spatiotemporal big data store.
future	可选布尔值。如果是 True ，将返回一个 future 对象，并且进程不会等待任务完成。默认为 False ，表示等待结果。

例子：

# Usage Example: To geocode a big data file share of mailing addresses in the United States Northwest.

geocode_server = "https://mymachine.domain.com/server/rest/services/USALocator/GeocodeServer"
geo_parameters = {"field_info": "[('ObjectID', 'TEXT', 255), ('Street', 'TEXT', 255), ('City', 'TEXT', 255), ('Region', 'TEXT', 255), ('State', 'TEXT', 255)]", "column_names": "", "file_type": "table", "header_row_exists": "true", "field_mapping": "[["Street", "Street"], ["City", "City"], ["State", "State"], ["ZIP", "ZIP"]]"}
geocode_result = find_locations.geocode_locations(input_layer=NW_addresses,
                                            output_name="geocoded_NW_USA",
                                            geocode_service=geocode_server,
                                            geocode_parameters = geo_parameters)