ファイルのジオコーディング (ジオコーディングツール)

サマリー

住所または場所の大きなローカルテーブルをフィーチャクラスのポイントに変換するか、CSV または XLS テーブルとして変換します。このツールは、ArcGIS Enterprise ポータルでホストされているロケーターを使用します。

使用法

このツールは入力として次のテーブル形式をサポートします:
- カンマ区切り値のファイル (.csv)
- ファイルジオデータベーステーブル
- Microsoft Excel ワークシート (.xls および .xlsx ファイル)
入力 CSV テーブルの場合、入力ファイルの最初の行は、ロケーターから追加されるフィールドとともに、出力テーブルのフィールド名として使用されます。フィールド名には、空白文字または特殊文字 ($ や * など) は使用できません。

ArcGIS Pro での Microsoft Excel ファイルの操作の詳細

注意:

ファイルジオデータベース形式の入力テーブルでジオコード結果を返す最も簡単な方法は、ファイルジオデータベースの内容を制限するか、テーブルを 1 つ含むファイルジオデータベースを指定することです。
単一のフィールドに格納されている住所、複数のフィールドに分割されている住所、または 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 になります。
このツールを使用するには、ArcGIS Enterprise 10.7 以降のポータルが必要です。
ユーティリティーサービスとしてポータルで使用できないポータルロケーターがある場合は、そのロケーターをポータルユーティリティーサービスとして追加し、バッチジオコーディングに対応できる構成にするようポータル管理者に依頼します。
複数のスレッドを使用するように構成された ArcGIS Enterprise ポータルでロケーターを使用すると、ジオコーディングのパフォーマンスが向上します。
ジオコーディング結果はロケーターと同じ空間参照内に保存されます。出力の空間参照を変更するには、このツールの環境設定で異なる出力座標系を設定します。
ジオコーディング結果には、スコア、ステータス、各レコードの一致した住所など、関連するすべてのジオコーディング情報だけでなく、元の入力テーブル内の値も含まれます。このツールで生成されるジオコーディングの結果には、元の入力テーブルの静的なスナップショットが含まれるため、元のテーブルで値の追加や更新を行っても、その結果は出力ファイルに反映されません。ツールを再実行して、これらの変更を含む新しい出力ファイルを作成します。
ジオコーディング結果がフィーチャクラスとして返された場合に、住所の再照合を行うには、住所の再照合 ツールを使用するか、または 住所の再照合 ウィンドウを開く 住所の再照合 オプションを使用します。

注意:

バッチジオコーディングに複数のスレッドを使用する ArcGIS Enterprise 10.8 ポータルのロケーターを使用して、テーブルをジオコーディングする必要があります。

[ジオコーディング結果の再照合の詳細] (../../help/data/geocoding/rematch-locations-converted-from-a-table.md)
Z 対応データで構築された入力ロケーターを使用する場合、ツールは Z 対応でない出力を返します。このツールでは、2D 出力のみがサポートされています。
国または地域、 優先位置タイプ、 カテゴリー のパラメーターは、 ロケーター パラメーターの値に使用されるすべてのロケーターでサポートされているわけではありません。
ArcGIS Pro 3.2 で作成されたロケータービューの構成を ロケーター パラメーター値として使用した場合、ツールはその構成を適用しません。

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

派生した出力

ラベル	説明	データタイプ
出力フィーチャクラス	出力フィーチャクラス。	Feature Class
出力テーブル	CSV または XLS 形式の出力テーブルです (選択した出力タイプの値によって異なります)。	Table

arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})

名前	説明	データタイプ
in_table	ジオコーディングする住所または場所を含む CSV、XLS、XLSX 形式の入力テーブル、またはファイルジオデータベーステーブル。	Record Set
locator	テーブルのジオコーディングに使用されるポータルロケーター。自動入力されたリストからアクティブなポータル上のロケーターを選択するか、アクティブなポータルを参照して他の使用可能なロケーターを選択します。アクティブなポータルでユーティリティーサービスとして設定されたロケーターをデフォルトで使用できます。注意: このツールでは、ArcGIS World Geocoding Service は無効になっています。 ArcGIS World Geocoding Service を使用する場合は、住所のジオコーディングツールを使用します。	Address Locator
address_fields	このパラメーターでマッピングしている各フィールドの形式は `input_locator_field, table_field_name` です。ここで、`input_locator_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
output_type	ジオコード結果が書き込まれるファイルタイプを指定します。 `CSV`—`.csv` ファイルが返されます。 `FEATURE_CLASS`—ファイルジオデータベース内のフィーチャクラスが返されます。 `XLS`—`.xls` ファイルが返されます。	String
output_location	出力ジオコーディング結果が書き込まれるフォルダー。出力が `.csv` または `.xls` ファイルの場合、出力ファイルは指定されたフォルダーに配置されます。出力がフィーチャクラスの場合、出力ファイルジオデータベースが作成され、指定されたフォルダーに配置されます。新しいファイルジオデータベースには、ジオコーディングされたフィーチャクラスが含まれます。出力ファイルジオデータベースとファイルジオデータベース内のフィーチャクラスの名前は同じです。	Workspace
output_name	ジオコーディングされた出力結果の名前。	String
country [country,...] (オプション)	ジオコーディングされた住所について、検索対象をそれらの国に制限する、1 つまたは複数の国。国を指定すると、多くの場合、ジオコーディングの精度が向上します。国を指定しないと、ロケーターでサポートされているすべての国を使用してジオコーディングが実行されます。 `in_table` パラメーターの値のフィールドが、`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` フィールドが格納されます。結果が `.csv` または `.xls` ファイルの場合、`Shape X` および `Shape Y` フィールドが格納されます。 `MINIMAL`—場所とその場所がジオコード結果のロケーター内の情報にどれだけ一致しているかが記述されたフィールド (`Shape`、`Status`、`Score`、`Match_type`、`Match_addr`、および `Addr_type`) が追加されます。 `MINIMAL_AND_USER`—`MINIMAL` フィールドと、ユーザー定義のカスタム出力フィールドが追加され、ジオコード結果で返されます。	String

派生した出力

名前	説明	データタイプ
out_feature_class	出力フィーチャクラス。	Feature Class
out_table	CSV または XLS 形式の出力テーブルです (選択した出力タイプの値によって異なります)。	Table

コードのサンプル

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

次の Python スクリプトは、スタンドアロンスクリプトで GeocodeFile 関数を使用する方法を示しています。

注意:

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

import arcpy

# Input is a local table
input_table = r"C:\data\customers.csv"

# This tool works with locators on a portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_name>"

# The best way to generate a field mapping is to run the tool in ArcGIS
# Pro, right-click the green success ribbon, and click "Copy Python command"

field_mapping = "'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 VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"

# Output folder for the output CSV, Excel, or GDB table. If you select
# FEATURE_CLASS output_type, a new GDB will be created in the
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the
# in_locator that you use.
country = None
location_type = "ROUTING_LOCATION"
category = "'Street Address'"

arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type,
                            output_folder, output_name, country, location_type,
                            category)

環境

現在のワークスペース, 出力座標系

ライセンス情報

Basic: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です
Standard: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です
Advanced: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です

ファイルのジオコーディング (ジオコーディング ツール)

サマリー

使用法

注意:

注意:

パラメーター

注意:

注意:

派生した出力

環境

ライセンス情報

関連トピック

ファイルのジオコーディング (ジオコーディングツール)