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`>