テーブルから場所をジオコーディング (ジオコーディング ツール)
サマリー
ArcGIS Enterprise ポータル上でホストされているロケーターを使用して、ホストされているテーブルをジオコーディングします。これにより、ジオコーディングの結果を含むホスト フィーチャ レイヤーが作成されます。
このツールは、ポータルに公開されたテーブルをジオコーディングして、その出力をポータルに保存する処理を自動化するように設計されています。 ジオコーディングの結果がポータルに保存されないようにする場合は、テーブルのジオコーディング 住所のジオコーディング
注意:
このツールを実行するには、ポータルの公開者または管理者権限が必要です。 カスタム ロールのメンバーである場合は、ポータル管理者からホスト Web レイヤーの公開の権限が付与されていることを確認します。
使用法
単一のフィールドに格納されている住所、複数のフィールドに分割されている住所、または 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.6 以降が必要です。
複数のスレッドを使用するように構成 された ArcGIS Enterprise ポータルでロケーターを使用すると、ジオコーディングのパフォーマンスが向上します。
入力テーブルには、ArcGIS Enterprise ポータルでホストまたは公開されているテーブルを指定する必要があります。 ホストされているテーブルはホスト フィーチャ レイヤーの一部と見なされるため、このツールで使用する前に、ポータルでアイテムとして作成しておく必要があります。 詳細については、「ホスト フィーチャ レイヤーの公開 」をご参照ください。
出力ホスト フィーチャ レイヤーは住所ロケーターと同じ空間参照内に保存されます。 出力フィーチャ レイヤーの空間参照を変更するには、このツールの環境設定 で異なる出力座標系 を設定します。
出力ホスト フィーチャ レイヤーには、スコア、ステータス、各レコードの一致した住所など、関連するすべてのジオコーディング情報だけでなく、元の入力テーブル内の値も含まれます。 住所の再照合を行うには、住所の再照合 住所の再照合 ウィンドウを開く 住所の再照合 オプションを使用します。 このツールで生成されるジオコーディングの結果には、元の入力テーブルの静的なスナップショットが含まれるため、元のテーブルで値の追加や更新を行っても、その結果が出力フィーチャ サービスに反映されません。 これらの変更を含む出力フィーチャ サービスを作成するには、このツールを再実行します。
[ジオコーディング結果の再照合の詳細]
(../../help/data/geocoding/rematch-locations-converted-from-a-table.md)
Z 対応データで構築された入力ロケーターを使用する場合、ツールは Z 対応でない出力を返します。 このツールでは、2D 出力のみがサポートされています。
国または地域 、 優先位置タイプ 、 カテゴリー のパラメーターは、 住所ロケーター パラメーターの値に使用されるすべてのロケーターでサポートされているわけではありません。
ArcGIS Pro 3.2 で作成されたロケーター ビュー の構成を 住所ロケーター パラメーター値として使用した場合、ツールはその構成を適用しません。
パラメーター
ラベル
説明
データ タイプ
入力テーブル
ジオコーディングされる住所または場所が含まれるポータル上のテーブル。
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
出力フィーチャ レイヤー名
ポータル上に作成する出力ジオコード フィーチャ レイヤーの名前。
String
国または地域
(オプション)
ジオコーディングされた住所について、検索対象をそれらの国に制限する、1 つまたは複数の国。 国を指定すると、多くの場合、ジオコーディングの精度が向上します。 国を指定しないと、ロケーターでサポートされているすべての国を使用してジオコーディングが実行されます。
住所フィールドのマッピング パラメーターの 1 つのフィールドと国フィールド を指定すると、このパラメーターの値はオーバーライドされます。
String
優先位置タイプ
(オプション)
PointAddress の一致で返される優先出力ジオメトリーを指定します。 優先位置がデータに存在しない場合は、 住所の位置 のデフォルトの位置が返されます。 geocodeAddresses の locationType パラメーター
String
カテゴリー
(オプション)
ロケーターが検索する場所のタイプを制限します。これにより、偽陽性の一致、希望しない住所レベルの一致、あいまいな座標検索が除外されます。 このパラメーターは、検索プロセスを高速化するために役立ちます。 カテゴリーを使用しないと、サポートされているすべてのカテゴリーを使用してジオコーディングが実行されます。 すべてのカテゴリー値がすべての場所と国でサポートされているとは限りません。
カテゴリー フィルター の詳細については、ArcGIS REST API Web ヘルプをご参照ください。
String
出力フィールド
(オプション)
ジオコード結果で返されるロケーター出力フィールドを指定します。
位置のみ 、 最小 、または 最小およびユーザー フィールド オプションが指定されている場合、 入力テーブル パラメーターの値にある元のフィールド名は保持されます。
注意:
このパラメーターは、ArcGIS Enterprise 10.9 以降に公開されている ロケーターの作成 フィーチャ ロケーターの作成 住所ロケーターの作成 ツールを使用して作成されたロケーターが 1 つ以上含まれているコンポジット ロケーターでは、このパラメーターを使用できません。
すべて 使用可能なすべてのロケーター出力フィールドがジオコード結果に含まれます。 これがデフォルトです。
位置のみ Shape フィールドがジオコーディング結果に格納されます。
最小 場所とその場所がジオコード結果のロケーター内の情報にどれだけ一致しているかが記述されたフィールド (Shape、Status、Score、Match_type、Match_addr、および Addr_type) が追加されます。
最小およびユーザー フィールド MINIMAL フィールドと、ユーザー定義のカスタム出力フィールドが追加され、ジオコード結果で返されます。
String
派生した出力
ラベル
説明
データ タイプ
出力レイヤー
ポータル内の出力ジオコード結果フィーチャ レイヤーへのハイパーリンク。 出力フィーチャ レイヤー名 の値からフィーチャ レイヤーの名前が取得されます。
Feature Set
arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})
名前
説明
データ タイプ
in_table
ジオコーディングされる住所または場所が含まれるポータル上のテーブル。
Record Set
in_address_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 です。ここで、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_name
ポータル上に作成する出力ジオコード フィーチャ レイヤーの名前。
String
country
[country,...]
(オプション)
ジオコーディングされた住所について、検索対象をそれらの国に制限する、1 つまたは複数の国。 国を指定すると、多くの場合、ジオコーディングの精度が向上します。 国を指定しないと、ロケーターでサポートされているすべての国を使用してジオコーディングが実行されます。
in_table パラメーターの値のフィールドが、address_fields パラメーターの Country フィールドにマップされているとき、このパラメーターの値はオーバーライドされます。
2 文字または 3 文字の国コードとしてカンマ区切り形式で値を指定します。 使用する入力値については、「サポートされている国コード列 」をご参照ください。
String
location_type
(オプション)
PointAddress の一致で返される優先出力ジオメトリーを指定します。 優先位置がデータに存在しない場合は、ADDRESS_LOCATION のデフォルトの位置が返されます。 geocodeAddresses の locationType パラメーター
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_ONLYShape フィールドがジオコーディング結果に格納されます。
MINIMAL場所とその場所がジオコード結果のロケーター内の情報にどれだけ一致しているかが記述されたフィールド (Shape、Status、Score、Match_type、Match_addr、および Addr_type) が追加されます。
MINIMAL_AND_USERMINIMAL フィールドと、ユーザー定義のカスタム出力フィールドが追加され、ジオコード結果で返されます。
String
派生した出力
名前
説明
データ タイプ
output_layer
ポータル内の出力ジオコード結果フィーチャ レイヤーへのハイパーリンク。 出力フィーチャ レイヤー名 の値からフィーチャ レイヤーの名前が取得されます。
Feature Set
コードのサンプル
GeocodeLocationsFromTable の例 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトは、GeocodeLocationsFromTable 関数を使用してホスト テーブル レイヤーをジオコーディングする方法を示しています。
注意:
お使いのポータルにあるロケーターを操作する場合は、ログインしていること、およびそのポータルを ArcGIS Pro でアクティブなポータルとして設定していることを確認してください。 アクティブなポータル以外のポータルにあるロケーターにアクセスするには、SignInToPortal
import arcpy
# Input is a hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"
# This tool works with locators on your portal
in_locator = "https://<machine_name>/server/rest/services/<locator_name>/GeocodeServer/<locator_name>"
# The easiest way to generate a field mapping is to run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping = "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"
# Optional geocoding parameters. Only some are supported depending on the
# in_locator that you use.
country = None
location_type = None
category = None
# The output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator,
field_mapping, output_name, country,
location_type, category)
環境
出力座標系
ライセンス情報
Basic: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です
Standard: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です
Advanced: ArcGIS Enterprise のアカウントに、解析の実行権限が必要です