サマリ
住所ロケーターを作成します。住所ロケーターは住所の位置検索、住所テーブルのジオコーディング、またはポイント位置の住所の取得に使用することができます。
使用法
住所ロケーターは、参照データと同じワークスペース、または指定したジオデータベースまたはファイル フォルダー内のワークスペースに作成することができます。ベスト プラクティスおよびジオコーディング パフォーマンスの向上を実現するために、ロケーターをジオデータベースではなく、ファイル フォルダーに保存することをお勧めします。
参照データセットの役割は、住所ロケーターに対する参照データとしての振舞いを定義したものです。ArcGIS で提供される住所ロケーター スタイルでは次の値を使用して、参照データセットの役割を記述します。
- プライマリ テーブル - プライマリ参照データセットのフィーチャクラスをロケーター用に定義します (道路中心線のフィーチャクラスなど)。これは必須のテーブルです。
- 別名テーブル - 道路またはポイント フィーチャに対する別名を含む、代替の道路名テーブルを定義します。プライマリ テーブルを結合するために使用される JoinID がテーブルに必要になります。このテーブルはオプションです。
- エイリアス テーブル - 場所名および名前に対する実際の住所を含む、場所名のエイリアス テーブルを定義します。ユーザーは「Field Museum」などの場所名または「1400 S Lakeshore Drive Chicago, IL 60605」などの住所で位置を検索することができます。このテーブルはオプションです。
カスタム ロケーター スタイルまたはサード パーティが提供するロケーター スタイルによって、参照データのフィーチャセットおよびテーブルに対して異なる役割が定義される場合があります。参照データセットに対して定義される役割に関する情報については、それぞれのドキュメントをご参照ください。
コンポジット住所ロケーターはこのツールでは作成できません。[コンポジット住所ロケーターの作成 (Create Composite Address Locator)] ツールを使用して、コンポジット住所ロケーターを作成します。
構文
CreateAddressLocator_geocoding (in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})| パラメータ | 説明 | データ タイプ |
in_address_locator_style | 住所ロケーター スタイル。新しい住所ロケーターはこの住所ロケーター スタイルに基づいて作成されます。 | Address Locator Style |
in_reference_data [[Reference Data, {Role}],...] | 住所ロケーターによって使用される参照データのフィーチャクラス、テーブル (役割も含む)。
カスタム ロケーター スタイルまたはサード パーティが提供するロケーター スタイルによって、参照データセットに対して異なる役割セットが定義される場合があります。 | Value Table |
in_field_map | 住所ロケーター スタイルが使用する参照データ フィールドの、参照データセット内のフィールドへのマッピング。このパラメーターでの各フィールド のマッピングは次の形式に則しています。 「<locator field alias>」は住所ロケーターによって使用される参照データのエイリアス名を表します。また、「<dataset field name>」は参照データセットのフィールド名を表します。名前にアスタリスク (「*」) が付いたフィールドは、住所ロケーター スタイルでは必須です。 VISIBLE はフィールドを表示することを表し、NONE はジオメトリが元の値のコピーであることを表します。 住所ロケーター スタイルで使用されるオプションの参照データ フィールドを参照データセットにマッピングしないことを選択する場合、フィールド名の代わりに「<None>」を使用してマッピングしないことを示します。 ロケーター スタイルで使用される参照データ フィールドのエイリアス名を決定するには、[住所ロケーターの作成 (Create Address Locator)] ツール ダイアログ ボックスを開いてロケーター スタイルを選択します。[フィールド マップ] コントロールの [フィールド名] 列に表示される名前がフィールドのエイリアス名です。 | Field Info |
out_address_locator | 作成する住所ロケーター。 | Address Locator |
config_keyword (オプション) | RDBMS (Relational Database Management System) 内のテーブルの格納パラメーターを決定するコンフィグレーション キーワード (エンタープライズおよびファイル ジオデータベースのみ)。 | String |
enable_suggestions (オプション) | クライアント アプリケーションでユーザーが入力するときに、文字単位の候補の表示を自動で生成することができます。この機能を使用すると、一致候補が取得される前に入力する必要がある文字数が削減されるため、検索時の対話的なユーザー操作が簡単になります。クライアント アプリケーションでは、候補のリストを表示することができます。このリストは、探している場所がリストに返されるまで、ユーザーが文字を入力するたびに更新されます。 Esri が提供するロケーター スタイル以外は、候補の表示を有効化したロケーターの作成に使用できません。候補の表示機能は、Esri 提供のロケーターがジオコード サービスとして公開されている場合に限り、表示されます。候補の表示機能を有効化したロケーターを保存できる場所は、ファイル フォルダーのみです。ジオデータベースには保存できません。
| Boolean |
コードのサンプル
CreateAddressLocator (住所ロケーターの作成) の例 (Python ウィンドウ)
次の Python ウィンドウ スクリプトで、CreateAddressLocator (住所ロケーターの作成) 関数をイミディエイト モードで使用する方法を示します。
# Create a street address locator using a street centerline feature class
# in a file geodatabase as reference data.
# The new address locator will be created in the same file geodatabase.
# Import system modules
import arcpy
from arcpy import env
env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets Primary", "'Feature ID' FeatureID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left Zipcode' ZIPL VISIBLE NONE;'Right Zipcode' ZIPR VISIBLE NONE;'Left State' State_Abbr VISIBLE NONE;'Right State' State_Abbr VISIBLE NONE", Atlanta_AddressLocator, "", "DISABLED")
環境
ライセンス情報
- ArcGIS for Desktop Basic: ○
- ArcGIS for Desktop Standard: ○
- ArcGIS for Desktop Advanced: ○