概要
住所テーブルをジオコーディングします。この処理にはジオコーディングしたい住所を格納するテーブルと、住所ロケーターまたはコンポジット住所ロケーターが必須です。このツールは住所ロケーターに対して住所を照合し、各入力レコードの処理結果を新しいポイント フィーチャクラスに保存します。ArcGIS World Geocoding Service を使用している場合、この操作でクレジットが消費されることがあります。
図
使用法
単一のフィールドに格納されている住所または複数のフィールドに分割されている住所をジオコーディングすることができます。単一の入力フィーチャには、完全な住所が格納されています。たとえば、「303 Peachtree St NE, Atlanta, GA 30308」のようになります。入力住所が、米国の一般的な住所に使用される Address、City、State、および ZIP などの複数のフィールドに分割されている場合、複数のフィールドがサポートされます。
一部のロケーターは、複数の入力住所フィールド (Address、Address2、Address3 など) をサポートしています。この場合、住所コンポーネントを複数のフィールドに分割して、ジオコーディングのときに住所フィールドを連結することができます。たとえば、3 つのフィールドに 100、Main St、Apt 140 がある場合や、2 つのフィールドに 100 Main St と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main St Apt 140 になります。
出力フィーチャクラスは住所ロケーターと同じ空間参照内に保存されます。出力フィーチャクラスの空間参照を変更するには、ツールの環境設定で異なる出力座標系を設定します。
出力フィーチャクラスは、各レコードの入力アドレスおよびその他の情報 (スコア、ステータス、照合された住所など) をデフォルトで格納します。ArcMap の [住所の再照合 (Rematch Addresses)] ツールまたは [対話的に再照合] ダイアログ ボックスのいずれかを使用して、住所を再照合することができます。一度、照合処理が終了しフィーチャクラスが作成されると、入力アドレス テーブル内の住所の変更は出力フィーチャクラスの結果には反映されません。
入力アドレス テーブルが更新されたときに出力フィーチャクラスの照合結果を自動的に更新したい場合、[ダイナミック出力フィーチャクラス] パラメーターを TRUE (オン) に設定します。リレーションシップ クラスが入力テーブルおよび出力フィーチャクラスに作成されます。ArcMap の編集セッション中に入力テーブルの住所が変更されると住所はすぐに再度ジオコーディングされ、出力フィーチャクラスの関連するレコードが新しいジオコーディング結果に更新されます。自動更新は入力テーブル内の新しいレコードの追加または既存のレコードの削除にも対応しています。
ArcGIS World Geocoding Service を使用して住所のテーブルを照合するには、ArcGIS Online 組織向けプラン サブスクリプションが必要です。詳細については、「ArcGIS Online の World Geocoding Service の操作」をご参照ください。
構文
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})| パラメーター | 説明 | データ タイプ |
in_table | ジオコーディングする住所テーブル。 | Table View |
address_locator | 住所テーブルのジオコーディングに使用する住所ロケーター。 | Address Locator |
in_address_fields [input_address_field, table_field_name] | input_address_field が住所ロケーターで指定された入力住所フィールドの名前で、table_field_name がジオコーディングする住所のテーブルで対応するフィールドの名前である場合、このパラメーターでマッピングしている各フィールドの形式は、input_address_field, table_field_name となります。 「303 Peachtree St NE, Atlanta GA 30308」のような完全な住所を保存する、単一入力フィールドを指定できます。または、入力住所が、米国の一般的な住所に使用される Address、City、State、および ZIP などの異なるフィールドに分割されている場合は、複数のフィールドを指定できます。 一部のロケーターは、複数の入力住所フィールド (Address、Address2、Address3 など) をサポートしています。この場合、住所コンポーネントを複数のフィールドに分割して、ジオコーディングのときに住所フィールドを連結することができます。たとえば、3 つのフィールドに 100、Main St、Apt 140 がある場合や、2 つのフィールドに 100 Main St と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main St Apt 140 になります。 住所ロケーターで使用されるオプションの入力住所フィールドを入力アドレス テーブル内のフィールドにマッピングしないことを選択する場合、フィールド名の代わりに <None> を使用してマッピングしないことを示します。 | Field Info |
out_feature_class | ジオコーディングされた出力フィーチャクラスまたはシェープファイル。 | Feature Class |
out_relationship_type (オプション) | ジオコーディング フィーチャクラス内の住所テーブルの静的コピーを作成するのか、または動的に更新されるジオコーディング フィーチャクラスを作成するのかを示します。
| Boolean |
country [country,...] (オプション) | ジオコーディングは、選択した国に制限されます。国を使用しない場合、ジオコーディングはサポートされているすべての国に対して実行されます。ほとんどの場合、国を選択するとジオコーディングの精度が向上します。 [入力テーブル] に国を表すフィールドがあり、そのフィールドが CountryCode の [入力住所フィールド] にマップされる場合、[入力テーブル] の値の方が、[国] パラメーターよりも優先されます。入力値は ISO 3166-1 の国コード (3 文字) で指定してください。 このパラメーターは、すべてのロケーターではサポートされていません。 | String |
location_type (オプション) | [PointAddress] の一致用の優先出力ジオメトリを指定します。オプションは、道路の側の位置で、ルート検索や、住所の屋上またはパーセルの重心に使用できます。優先位置がデータに存在しない場合、代わりにデフォルトの位置が返されます。[Addr_type=PointAddress] のジオコード結果の場合、X,Y 属性値は道路に沿った住所の座標を記述し、DisplayX および DisplayY の値は屋上または建物の重心の座標を記述します。geocodeAddresses の [locationType] パラメーターの詳細については、REST API Web ヘルプをご参照ください。 このパラメーターは、すべてのロケーターではサポートされていません。
| String |
コードのサンプル
GeocodeAddresses (住所のジオコーディング) の例 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、マルチライン ジオコーディングを使用して GeocodeAddress 関数をイミディエイト モードで使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
GeocodeAddresses (住所のジオコーディング) の例 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、シングルライン ジオコーディングを使用して GeocodeAddress 関数をイミディエイト モードで使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "'Single Line Input' SINGLELINE"
geocode_result = "singleline_geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
環境
ライセンス情報
- Basic: 制限付き
- Standard: はい
- Advanced: はい