ラベル | 説明 | データ タイプ |
国または地域 | 住所をコンポーネントに分割するために使用する、国の住所構成を指定します。 デフォルトは、オペレーティング システムの地域設定です。
| String |
入力住所データ | 個別のストリート住所コンポーネントに分割可能なストリート住所情報を含むテーブルまたはフィーチャクラス。 都市、近郊、小区域、郵便番号などのゾーン情報はサポートされていません。 | Table View |
入力住所フィールド | 連結すると分割対象のストリート住所を形成する、入力テーブルまたはフィーチャクラスのフィールド。 都市、近郊、小区域、郵便番号などのゾーン情報はサポートされていません。 フィールドが選択された順序は、フィールドが連結される順序です。 | String |
出力住所データ | 分割されたストリート住所を含む出力フィーチャクラスまたはテーブル。 | Dataset |
例外ファイル (オプション) | ストリートの区切り例外を含むテーブル。 テーブルはサポートされている任意のテーブル形式です。 | Table View |
サマリー
ストリート住所情報を住所コンポーネントに分割し、一意のフィールドとして追加される追加のコンポーネントを使用してテーブルまたはフィーチャクラスを作成します。
図
使用法
入力住所データは、個別のストリート住所コンポーネントに解析または分割可能なストリート住所属性を含むテーブルまたはフィーチャクラスになります。
分割対象の入力ストリート住所は、ツールで入力住所フィールドとして選択した単一フィールド (StreetName や Address など) に格納できます。
番地とユニット情報が個別のフィールドに格納されている場合など、入力ストリート住所も複数のフィールドに格納できます。 この場合、フィールドは選択された順序でリアルタイムで連結され、ストリート住所はそのコンポーネントに分割されます。
都市、近郊、小区域、郵便番号などのゾーン情報を入力ストリート住所に含めないでください。 これらのコンポーネントは処理中には解析されず、含めると正しくない結果が生成されます。
[例外ファイル] パラメーター値に、カスタム区切り形式を持つ各レコードの行を含む必要があります。 期待される分割された住所コンポーネントが後に続く入力住所フィールド (複数のフィールドがある場合は、値を 1 つの文字列に連結する) を含むように、ファイルの書式を設定します。 分割住所コンポーネントのフィールド名は以下に一致する必要があります。
- AddNum
- StPreDir
- StPreType
- StName
- StType
- StDir
- UnitType
- UnitName
- BuildingType
- BuildingUnit
- LevelType
- LevelName
注意:
すべてのフィールドが必要なわけではありません。コンポーネントへの分割が必要な場合に、カスタム住所に基づくフィールドのみ必要です。
注意:
詳細については、「例外ファイルの例」をダウンロードしてください。
ファイル内の最初の住所 123 South Beach Avenue は通常、次のフィールドに分割されます。
AddNum StPreDir StName StType 123
South
Beach
Avenue
ただし、例外ファイルは次のカスタムの分割を作成します。
AddNum StName StType 123
South Beach
Avenue
このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサや、複数のコアを持つプロセッサが搭載されている場合は、特に大きいデータセットの住所を分割するときにパフォーマンスが向上します。 「並列処理ファクター」環境が設定されていない場合 (デフォルト)、テーブルのサイズと論理コアの数に基づいて並列処理がスケーリングされます。 50 行未満のテーブルでは 1 つの処理しか使用されませんが、行数の多いテーブルでは、このツールによってコンピューターの論理プロセッサの数までプロセスの数がスケーリングされます。 この環境を 0 に設定すると、並列処理は無効になります。 ファクターを 1 ~ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を特定します。 この数式の結果が 0 または 1 の場合、並列処理は有効化されません。
このツールで生成された出力ファイルは、「分割住所の確認」ウィンドウで確認および更新することができます。 このプロセスでは例外ファイルの生成や更新した例外ファイルへの追加もできます。このファイルは、今後このツールでデータを分割するときに [例外ファイル] パラメーターで使用できます。
パラメーター
arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})
名前 | 説明 | データ タイプ |
country_code | 住所をコンポーネントに分割するために使用する、国の住所構成を指定します。 デフォルトは、オペレーティング システムの地域設定です。
| String |
in_address_data | 個別のストリート住所コンポーネントに分割可能なストリート住所情報を含むテーブルまたはフィーチャクラス。 都市、近郊、小区域、郵便番号などのゾーン情報はサポートされていません。 | Table View |
in_address_fields [in_address_fields,...] | 連結すると分割対象のストリート住所を形成する、入力テーブルまたはフィーチャクラスのフィールド。 都市、近郊、小区域、郵便番号などのゾーン情報はサポートされていません。 フィールドが選択された順序は、フィールドが連結される順序です。 | String |
out_address_data | 分割されたストリート住所を含む出力フィーチャクラスまたはテーブル。 | Dataset |
in_exceptions (オプション) | ストリートの区切り例外を含むテーブル。 テーブルはサポートされている任意のテーブル形式です。 | Table View |
コードのサンプル
単一フィールドの住所文字列を含むテーブルを個別のコンポーネントに分割します。
import arcpy
atlanta_addresses = r"C:\AtlantaAddresses.csv"
arcpy.geocoding.SplitAddressIntoComponents("USA", atlanta_addresses, "Address",
r"C:\MySplitAddresses.csv",
"ExceptionsFile.csv")