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)