住所のジオコーディング (ジオコーディングツール)

サマリー

住所テーブルをジオコーディングします。この処理にはジオコーディングしたい住所を格納するテーブルと、住所ロケーターまたはコンポジット住所ロケーターが必須です。このツールはロケーターに対して格納済みの住所を照合し、各入力レコードの処理結果を新しいポイントフィーチャクラスに保存します。 ArcGIS World Geocoding Service を使用している場合、この操作でクレジットが消費されることがあります。

ArcGIS World Geocoding Service を使用してジオコーディング操作を行うには ArcGIS 組織アカウントが必要で、クレジットが消費されます。ジオコーディングリクエストを最後まで完了するには、組織アカウントに十分なクレジットが必要です。

注意:

クレジットの推定は、アクティブなポータルが ArcGIS Online で、入力ロケーターが ArcGIS World Geocoding Service である場合に、ツールの上部で使用できます。

使用法

単一のフィールドに格納されている住所、複数のフィールドに分割されている住所、または 1 つのフィールドと国フィールドに格納されている住所をジオコーディングできます。単一の入力フィールドには、完全な住所が格納されています。たとえば、「303 Peachtree St NE, Atlanta, GA 30308」のようになります。入力住所が、米国の一般的な住所に使用される Address、City、State、ZIP などの複数のフィールドに分割されている場合、複数のフィールドがサポートされます。完全な住所 (303 Peachtree St NE, Atlanta, GA 30308 など) が格納される単一の入力フィールドと、その住所に関連付けられた国 (USA など) が格納されるフィールドもサポートされます。
一部のロケーターは、複数の入力住所フィールド (Address、Address2、Address3 など) をサポートしています。この場合、住所コンポーネントは複数のフィールドに分割可能で、これらの住所フィールドはジオコーディング時に連結されます。たとえば、3 つのフィールドに 100、Main st、Apt 140 がある場合や、2 つのフィールドに 100 Main st と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main st Apt 140 になります。
出力フィーチャクラスは住所ロケーターと同じ空間参照内に保存されます。出力フィーチャクラスの空間参照を変更するには、ツールの環境設定で異なる出力座標系を設定します。
出力フィーチャクラスは、各レコードの入力アドレスおよびその他の情報 (スコア、ステータス、照合された住所など) をデフォルトで格納します。住所の再照合を行うには、住所の再照合 ツールを使用するか、 住所の再照合 ウィンドウを開く 住所の再照合 オプションを使用します。一度、照合処理が終了しフィーチャクラスが作成されると、入力アドレステーブル内の住所の変更は出力フィーチャクラスの結果には反映されません。

[ジオコーディング結果の再照合の詳細] (../../help/data/geocoding/rematch-locations-converted-from-a-table.md)
ArcGIS World Geocoding Service を使用して住所のテーブルを照合するには、ArcGIS Online 組織向けプランのサブスクリプションが必要です。
国または地域、 優先位置タイプ、 カテゴリー のパラメーターは、 入力住所ロケーター パラメーターの値に使用されるすべてのロケーターでサポートされているわけではありません。
正確な Python 構文を生成するには、まず、 ジオプロセシング ウィンドウで適切なパラメーターオプションを使用してツールを実行します。次に、実行メニューを開いて Python コマンドのコピー オプションを選択します。
Z 対応ロケーターで住所または場所のテーブルをジオコーディングする場合は、ローカルシーンでこのツールを使用します。標高プロパティが 絶対高度 オプションに設定されていると、Z 対応のジオコード結果は自動的にローカルシーンに読み込まれます。

ローカルシーンに、ロケーター構築用のポイント参照データのデジタイズに使用された標高サーフェスが含まれている場合は、ジオコード結果の高度プロパティを 絶対高度 オプションに設定します。これを行うには、 レイヤープロパティ ダイアログボックスで、標高タブをクリックします。参照データの作成に使用された標高サーフェスがローカルシーンに含まれていない場合は、ジオコード結果の高度を 地表を基準 オプションに設定します。

レイヤーの高さ特性の定義の詳細

ラベル	説明	データタイプ
入力テーブル	ジオコーディングされる住所があるテーブル。	Table View
入力住所ロケーター	住所テーブルのジオコーディングに使用される住所ロケーター。注意: 必要に応じて、ロケーターパスの末尾にあるロケーター名の後に `.loc` 拡張子を付けます。	Address Locator
入力住所フィールド	住所ロケーターで使用される住所フィールドの、入力アドレステーブルのフィールドへのマッピング。完全な住所が、入力テーブルの 1 つのフィールドに格納されている場合 (たとえば、303 Peachtree St NE, Atlanta, GA 30308)、単一フィールドを指定します。入力住所が、米国の一般的な住所に使用される複数のフィールド (`Address`、`City`、`State`、`ZIP` など) に分割されている場合、複数フィールドを指定します。完全な住所と国が別々のフィールドに分かれている場合 (例: `Address` (303 Peachtree St NE, Atlanta, GA 30308) と `Country` (USA))、単一のフィールドと国フィールドを指定します。一部のロケーターは、複数の入力住所フィールド (`Address`、`Address2`、`Address3` など) をサポートしています。この場合、住所コンポーネントは複数のフィールドに分割可能で、これらの住所フィールドはジオコーディング時に連結されます。たとえば、3 つのフィールドに 100、Main st、Apt 140 がある場合や、2 つのフィールドに 100 Main st と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main st Apt 140 になります。住所ロケーターで使用されるオプションの入力住所フィールドを入力アドレステーブル内のフィールドにマッピングしない場合、フィールド名の代わりに <None> を使用してマッピングしないことを示します。	Field Info
出力フィーチャクラス	ジオコーディングされた出力フィーチャクラス。注意: シェープファイルの制限のため、シェープファイル形式への出力の保存はサポートされていません。	Feature Class
ダイナミック出力フィーチャクラス (オプション)	レガシー: このパラメーターは、ArcGIS Pro では効果がありません。 ArcGIS Desktop との後方互換性をサポートするために残されています。 ArcGIS Pro で使用できる値は `STATIC` のみです。オン—ArcGIS Pro ではこのオプションを使用できません。このツールについては、ArcGIS Desktop のヘルプをご参照ください。オフ—入力住所テーブル内のフィールドの静的コピーが出力フィーチャクラスに作成されます。使用できるのはこの値のみです。	Boolean
国または地域 (オプション)	ジオコーディングされた住所について、検索対象をそれらの国に制限する、1 つまたは複数の国。国を指定すると、多くの場合、ジオコーディングの精度が向上します。国を指定しないと、ロケーターでサポートされているすべての国を使用してジオコーディングが実行されます。入力住所フィールドパラメーターの 1 つのフィールドと国フィールドを指定すると、このパラメーターの値はオーバーライドされます。	String
優先位置タイプ (オプション)	`PointAddress` の一致で返される優先出力ジオメトリーを指定します。優先位置がデータに存在しない場合は、住所の位置のデフォルトの位置が返されます。 `geocodeAddresses` の `locationType` パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。住所の位置—屋根の位置、区画の重心、玄関などの住所位置を表すジオコード結果のジオメトリーが返されます。これがデフォルトです。ルート検索の位置—車両のルート検索に使用できる道路脇に近い位置を表すジオコード結果のジオメトリーを返します。	String
カテゴリー (オプション)	ロケーターが検索する場所のタイプを制限します。これにより、偽陽性の一致、希望しない住所レベルの一致、あいまいな座標検索が除外されます。このパラメーターは、検索プロセスを高速化するために役立ちます。カテゴリーを使用しないと、サポートされているすべてのカテゴリーを使用してジオコーディングが実行されます。すべてのカテゴリー値がすべての場所と国でサポートされているとは限りません。カテゴリーフィルターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。	String
出力フィールド (オプション)	ジオコード結果で返されるロケーター出力フィールドを指定します。位置のみ、最小、または最小およびユーザーフィールドオプションが指定されている場合、入力テーブルパラメーターの値にある元のフィールド名は保持されます。注意: このパラメーターは、ディスク上に保存されているか、ArcGIS Enterprise 10.9 以降に公開されているロケーターの作成またはフィーチャロケーターの作成ツールによって作成された入力ロケーターと共に使用できます。住所ロケーターの作成ツールを使用して作成されたロケーターが 1 つ以上含まれているコンポジットロケーターでは、このパラメーターを使用できません。すべて—使用可能なすべてのロケーター出力フィールドがジオコード結果に含まれます。これがデフォルトです。位置のみ—`Shape` フィールドがジオコーディング結果に格納されます。最小—場所とその場所がジオコード結果のロケーター内の情報にどれだけ一致しているかが記述されたフィールド (`Shape`、`Status`、`Score`、`Match_type`、`Match_addr`、および `Addr_type`) が追加されます。最小およびユーザーフィールド—`MINIMAL` フィールドと、ユーザー定義のカスタム出力フィールドが追加され、ジオコード結果で返されます。	String
一致するナラティブ (オプション)	一致するナラティブを出力ジオコードフィーチャクラスに返す方法を指定します。パラメーター値が指定されていない場合、一致するナラティブを含めるロケータープロパティ設定が使用されます。このパラメーターは、ジオコードフィーチャクラスでの住所の照合方法をより詳細に理解するのに役立ちます。 geocodeAddresses の returnMatchNarrative パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。一致するナラティブを出力に追加—`MatchNarrative` という名前のフィールドが、ジオコードフィーチャクラスに追加されます。このフィールドには、一致する各住所の一致するナラティブテキストが含まれます。一致するナラティブをフィールドに分割—単一フィールドの一致するナラティブテキストが、JSON オブジェクトから抽出されます。一致するナラティブテキストが解析され、個々のフィールドに分割されて、ジオコードフィーチャクラスに追加されます。	String

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields}, {match_narrative})

名前	説明	データタイプ
in_table	ジオコーディングされる住所があるテーブル。	Table View
address_locator	住所テーブルのジオコーディングに使用される住所ロケーター。注意: 必要に応じて、ロケーターパスの末尾にあるロケーター名の後に `.loc` 拡張子を付けます。	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` などの複数のフィールドに分割されている場合は、複数のフィールドを指定することもできます。完全な住所 (たとえば、303 Peachtree St NE, Atlanta, GA 30308) を格納する単一の入力フィールド、および住所に関連付けられている国 (例: USA) を格納するフィールドを指定することもできます。一部のロケーターは、複数の入力住所フィールド (`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 (オプション)	レガシー: このパラメーターは、ArcGIS Pro では効果がありません。 ArcGIS Desktop との後方互換性をサポートするために残されています。 ArcGIS Pro で使用できる値は `STATIC` のみです。 `DYNAMIC`—ArcGIS Pro ではこのオプションを使用できません。このツールについては、ArcGIS Desktop のヘルプをご参照ください。 `STATIC`—入力住所テーブル内のフィールドの静的コピーが出力フィーチャクラスに作成されます。使用できるのはこの値のみです。	Boolean
country [country,...] (オプション)	ジオコーディングされた住所について、検索対象をそれらの国に制限する、1 つまたは複数の国。国を指定すると、多くの場合、ジオコーディングの精度が向上します。国を指定しないと、ロケーターでサポートされているすべての国を使用してジオコーディングが実行されます。 `in_table` パラメーターの値のフィールドが、`in_address_fields` パラメーターの `Country` フィールドにマップされているとき、このパラメーターの値はオーバーライドされます。 2 文字または 3 文字の国コードとしてカンマ区切り形式で値を指定します。使用する入力値については、「サポートされている国コード列」をご参照ください。	String
location_type (オプション)	`PointAddress` の一致で返される優先出力ジオメトリーを指定します。優先位置がデータに存在しない場合は、`ADDRESS_LOCATION` のデフォルトの位置が返されます。 `geocodeAddresses` の `locationType` パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。 `ADDRESS_LOCATION`—屋根の位置、区画の重心、玄関などの住所位置を表すジオコード結果のジオメトリーが返されます。これがデフォルトです。 `ROUTING_LOCATION`—車両のルート検索に使用できる道路脇に近い位置を表すジオコード結果のジオメトリーを返します。	String
category [category,...] (オプション)	ロケーターが検索する場所のタイプを制限します。これにより、偽陽性の一致、希望しない住所レベルの一致、あいまいな座標検索が除外されます。このパラメーターは、検索プロセスを高速化するために役立ちます。カテゴリーを使用しないと、サポートされているすべてのカテゴリーを使用してジオコーディングが実行されます。すべてのカテゴリー値がすべての場所と国でサポートされているとは限りません。カテゴリーフィルターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。	String
output_fields (オプション)	ジオコード結果で返されるロケーター出力フィールドを指定します。 `LOCATION_ONLY`、`MINIMAL`、または `MINIMAL_AND_USER` オプションが指定されている場合、`in_table` パラメーターの値にある元のフィールド名は保持されます。注意: このパラメーターは、ディスク上に保存されているか、ArcGIS Enterprise 10.9 以降に公開されているロケーターの作成またはフィーチャロケーターの作成ツールによって作成された入力ロケーターと共に使用できます。住所ロケーターの作成ツールを使用して作成されたロケーターが 1 つ以上含まれているコンポジットロケーターでは、このパラメーターを使用できません。 `ALL`—使用可能なすべてのロケーター出力フィールドがジオコード結果に含まれます。これがデフォルトです。 `LOCATION_ONLY`—`Shape` フィールドがジオコーディング結果に格納されます。 `MINIMAL`—場所とその場所がジオコード結果のロケーター内の情報にどれだけ一致しているかが記述されたフィールド (`Shape`、`Status`、`Score`、`Match_type`、`Match_addr`、および `Addr_type`) が追加されます。 `MINIMAL_AND_USER`—`MINIMAL` フィールドと、ユーザー定義のカスタム出力フィールドが追加され、ジオコード結果で返されます。	String
match_narrative [match_narrative,...] (オプション)	一致するナラティブを出力ジオコードフィーチャクラスに返す方法を指定します。パラメーター値が指定されていない場合、一致するナラティブを含めるロケータープロパティ設定が使用されます。このパラメーターは、ジオコードフィーチャクラスでの住所の照合方法をより詳細に理解するのに役立ちます。 geocodeAddresses の returnMatchNarrative パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。 `ADD_MATCH_NARRATIVE`—`MatchNarrative` という名前のフィールドが、ジオコードフィーチャクラスに追加されます。このフィールドには、一致する各住所の一致するナラティブテキストが含まれます。 `SPLIT_MATCH_NARRATIVE`—単一フィールドの一致するナラティブテキストが、JSON オブジェクトから抽出されます。一致するナラティブテキストが解析され、個々のフィールドに分割されて、ジオコードフィーチャクラスに追加されます。	String

コードのサンプル

GeocodeAddresses の例 1 (スタンドアロンスクリプト)

次のスクリプトでは、GeocodeAddresses 関数を使用して、ローカルロケーターを使用した住所テーブルをジオコーディングする方法を示します。

import arcpy

arcpy.env.workspace = "C:\\Geocoding\\atlanta"

# Set local variables
table = "customers.dbf"
locator = "Atlanta_AddressLocator.loc"
field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator,
                                 field_map, geocode_result)

GeocodeAddresses の例 2 (スタンドアロンスクリプト)

次のスクリプトでは、GeocodeAddresses 関数を使用して、AGS 接続経由でサーバーロケーターを使用した住所テーブルをジオコーディングする方法を示します。

import arcpy

# Set local variables:
table = r"C:\data\Atlanta.gdb\customers"
locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
field_map = "'Single Line Input' SingleLine VISIBLE NONE"
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator,
                                 field_map, geocode_result)

GeocodeAddresses の例 3 (スタンドアロンスクリプト)

次のスクリプトでは、GeocodeAddresses 関数を使用して、ポータルロケーターを使用した住所テーブルをジオコーディングする方法を示します。

注意:

お使いのポータルにあるロケーターを操作する場合は、ログインしていること、およびそのポータルを ArcGIS Pro でアクティブなポータルとして設定していることを確認してください。アクティブなポータル以外のポータルにあるロケーターにアクセスするには、SignInToPortal 関数を使用して認証できます。

import arcpy

# Set local variables
table = r"C:\data\Atlanta.gdb\customers"
locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

GeocodeAddresses 例 4 (スタンドアロンスクリプト)

次のスクリプトでは、GeocodeAddresses 関数を使用して、ArcGIS World Geocoding Service を使用した住所テーブルをジオコーディングする方法を示します。

注意:

ArcGIS World Geocoding Service を使用している場合、この操作でクレジットが消費されることがあります。

import arcpy

# Set local variables
table = r"C:\data\Addresses.csv"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
             "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;Subregion <None> VISIBLE NONE;" +
             "Region <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
             "Country <None> VISIBLE NONE")

geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

GeocodeAddresses 例 5 (スタンドアロンスクリプト)

次のスクリプトでは、GeocodeAddresses 関数を使用して、ArcGIS World Geocoding Service を使用した住所テーブル (すべての住所データが単一のフィールドにあり、国データが 2 番目のフィールドにある) をジオコーディングする方法を示します。

注意:

ArcGIS World Geocoding Service を使用している場合、この操作でクレジットが消費されることがあります。

import arcpy

# Set local variables
table = r"C:\Data\MyDatabase.gdb\DistributionCenters"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = "'Single Line Input' SingleLine VISIBLE NONE;Country Country VISIBLE NONE"

geocode_result = r"C:\Data\MyDatabase.gdb\DistributionCenters_Geocoded"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

環境

出力データのコンフィグレーションキーワード, 出力座標系

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

住所のジオコーディング (ジオコーディング ツール)

サマリー

注意:

使用法

パラメーター

注意:

注意:

レガシー:

注意:

環境

ライセンス情報

関連トピック

住所のジオコーディング (ジオコーディングツール)