Python ArcGIS batch_geocode用法及代碼示例

本文簡要介紹 python 語言中 arcgis.geocoding.batch_geocode 的用法。

用法:

arcgis.geocoding.batch_geocode(addresses, source_country=None, category=None, out_sr=None, geocoder=None, as_featureset=False, match_out_of_range=True, location_type='street', search_extent=None, lang_code='EN', preferred_label_values=None, out_fields=None)

返回：

字典或 FeatureSet

batch_geocode 函數對整個地址列表進行地理編碼。

注意：

一次對多個地址進行地理編碼也稱為批量地理編碼。

Parameter	Description
addresses	字符串或字典的必需列表。要進行地理編碼的地址列表。要將位置名稱作為單行文本傳遞 - 單字段批量地理編碼 - 使用字符串。要將位置名稱作為多行文本多行批量地理編碼傳遞 - 使用 Geocoder 文檔中說明的地址字段。 注意： 可以在單個請求中進行地理編碼的最大地址數受限於定位器的 SuggestedBatchSize 屬性。 語法：addresses = [“380 New York St, Redlands, CA”, “1 World Way, Los Angeles, CA”, “1200 Getty Center Drive, Los Angeles, CA”, “5905 Wilshire Boulevard, Los Angeles, CA”, “100 Universal City Plaza, Universal City, CA 91608”, “4800 Oak Grove Dr, Pasadena, CA 91109”] OR 地址= [{ “Address”: “380 New York St.”, “City”: “Redlands”, “Region”: “CA”, “Postal”: “92373” },{ “OBJECTID”: 2, “Address”: “1 World Way”, “City”: “Los Angeles”, “Region”: “CA”, “Postal”: “90045” }]
source_country	可選字符串，source_country 參數僅受使用 StreetMap Premium 定位器發布的地理編碼器支持。 注意： 在 10.3 中添加，僅受使用 ArcGIS 10.3 for Server 和更高版本發布的地理編碼器支持。
category	可選字符串。 category 參數僅受使用 StreetMap Premium 定位器發布的地理編碼服務支持。
out_sr	可選字典，地理編碼請求返回的 x/y 坐標的空間參考。這對於使用具有不同於地理編碼服務的空間參考的Map的應用程序很有用。
as_featureset	可選布爾值，如果為 True，則結果集作為 FeatureSet 對象返回，否則為字典。
geocoder	可選 Geocoder ，要使用的地理編碼器。 注意： 如果未指定，則首先使用活動的GIS 實例Geocoder。
match_out_of_range	可選，一個布爾值，指定是否應返回 StreetAddress 匹配項，即使輸入門牌號超出為輸入街道定義的門牌號範圍。
location_type	可選，指定PointAddress 的輸出幾何匹配是否應該是屋頂點或街道入口位置。有效值為屋頂和街道。
search_extent	可選，一組邊界框坐標，將搜索區域限製在特定區域。輸入可以是定義邊界框的以逗號分隔的坐標列表，也可以是 JSON 信封對象。
lang_code	可選，設置返回地理編碼結果的語言。有關每個國家/地區的有效語言代碼值，請參閱受支持國家/地區表。
preferred_label_values	可選，允許通過指定輸出字段中應包含哪些地址組件值來簡單配置世界地理編碼服務響應中返回的輸出字段。支持單個值或以逗號分隔的值集合作為輸入。例如='匹配城市，主要街道'
out_fields	可選字符串。一串逗號分隔的字段名稱，用於限製地理編碼位置的返回屬性。

例子：

# Usage Example
>>> batched = batch_geocode(addresses = ["380 New York St, Redlands, CA",
                                                    "1 World Way, Los Angeles, CA",
                                                    "1200 Getty Center Drive, Los Angeles, CA",
                                                    "5905 Wilshire Boulevard, Los Angeles, CA",
                                                    "100 Universal City Plaza, Universal City, CA 91608",
                                                    "4800 Oak Grove Dr, Pasadena, CA 91109"]
                                    as_featureset = True,
                                    match_out_of_range = True,
                                    )
>>> type(batched)
<:class:`~arcgis.features.FeatureSet>