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>