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>