Python ArcGIS geocode用法及代码示例

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

用法:

arcgis.geocode(address, search_extent=None, location=None, distance=None, out_sr=None, category=None, out_fields='*', max_locations=20, magic_key=None, for_storage=False, geocoder=None, as_featureset=False, match_out_of_range=True, location_type='street', lang_code=None, source_country=None)

返回：

字典或 FeatureSet 对象。

geocode 函数对每个请求的一个位置进行地理编码。

Parameter	Description
address	字符串或字典的必需列表。指定要进行地理编码的位置。这可以是包含街道地址、地名、邮政编码或 POI 的字符串。 或者，这可以是包含相应地理编码器接受的各种地址字段的字典。这些字段列在关联地理编码器的 addressFields 属性中。例如，如果地理编码器的 address_fields 包含具有以下名称的字段：街道、城市、州和区域，则地址参数的格式为： { 街道：“1234 W Main St”，城市：“Small Town”，州：“WA”，区域：“99027” }
search_extent	可选字符串，一组边界框坐标，将搜索区域限制在特定区域。这对于用户仅在当前Map范围内搜索地点和地址的应用程序特别有用。
location	可选 [x,y]，定义与距离参数一起使用的原点位置，以根据其与位置的接近程度对地理编码候选者进行排序。
distance	可选浮点数，指定点位置周围区域的半径，用于提升地理编码候选者的排名，以便首先返回最接近该位置的候选者。距离值以米为单位。
out_sr	可选字典，地理编码请求返回的 x/y 坐标的空间参考。这对于使用具有不同于地理编码服务的空间参考的Map的应用程序很有用。
category	可选字符串，可用于过滤查找结果的地点或地址类型。该参数支持输入单个类别值或多个逗号分隔值。类别参数可以在带有或不带有文本参数的请求中传递。
out_fields	可选字符串，要包含的所有字段的名称。默认值为“*”，表示所有字段。
max_location	可选整数，要从服务返回的位置数。默认值为 20。
magic_key	可选字符串。当您传递有效文本和 magic_key 值时，查找操作可以更快地检索结果。
for_storage	可选布尔值。指定是否将持久化操作的结果。默认值为 false，表示操作的结果不能存储，但可以临时显示在Map上。 注意： 如果您将结果存储在数据库中，例如，您需要将此参数设置为 True 。
geocoder	可选，要使用的 Geocoder 。 注意： 如果未指定，则使用活动的 GIS 对象的第一个地理编码器。
as_featureset	可选布尔值，如果 True ，则结果集作为 FeatureSet 对象返回，否则为字典。
match_out_of_range	可选布尔值。通过指定当输入编号超出为输入街道定义的房屋范围时是否返回匹配项，为不精确的街道地址提供更好的空间精度。超出范围的匹配将被定义为Addr_type=StreetAddressExt。超出街道段范围 100 以上的输入门牌号码将不会导致 StreetAddressExt 匹配。此参数的默认值为 True。
location_type	可选的STR。指定是否将屋顶点或街道入口用作 PointAddress 匹配的输出几何。默认情况下，使用街道，这在路由场景中很有用，因为某些地址的屋顶位置可能会偏离街道较大的距离。但是，出于Map显示的目的，您可能希望改用屋顶，尤其是在对大型建筑物或地标进行地理编码时。 location_type 参数仅影响 JSON 响应中的位置对象，不会更改 x、y 或 DisplayX/DisplayY 属性值。 值：street 或 rooftop
lang_code	可选的字符串。设置返回地理编码结果的语言。
source_country	可选的字符串。对于 single-field 或多字段请求，将返回的候选人限制在指定的国家或地区。可接受的值包括 3 个字符的国家/地区代码。

例子：

# Usage Example
>>> geocoded = geocode(addresses = {
                                            Street: "1234 W Main St",
                                            City: "Small Town",
                                            State: "WA",
                                            Zone: "99027"
                                            },
                                    distance = 1000,
                                    max_locations = 50,
                                    as_featureset = True,
                                    match_out_of_range = True,
                                    location_type = "Street"
                                    )
>>> type(geocoded)
<:class:`~arcgis.features.FeatureSet>