リバースジオコーディング (ジオコーディングツール)

サマリー

フィーチャクラスのポイント位置から住所を生成します。リバースジオコーディング処理により、ロケーターの作成 ツールで作成したロケーターの最適化された距離値に基づいて、ポイント位置に最も近い住所、場所または交差点を検索します。

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

注意:

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

使用法

入力フィーチャクラスには、有効な XY 座標を持つポイント形状が必要です。 NULL 座標のポイントでは結果は返されません。
出力フィーチャクラスには入力フィーチャクラスと同数のレコードが含まれます。住所または場所の検索結果を含むフィールドがフィーチャクラスに追加されます。フィールド名は REV_ で始まります。一致する場所または住所を検索できない場合、フィールドは NULL 値になります。
入力フィーチャクラスの空間参照がロケーターと異なる場合、ロケーターはリアルタイムに座標を変換して一致の検索を試みます。出力フィーチャクラスは入力フィーチャクラスと同じ空間参照内に保存されます。出力フィーチャクラスの空間参照を変更するには、出力座標系環境を設定します。
入力フィーチャクラスのポイントで、一致する場所または住所が返されない場合、入力ポイントに関連付けられるフィーチャがロケーター内に存在しないことを意味します。ポイントが一致しない一般的な原因は、次のとおりです。
- ポイントが NULL 座標を含んでいる場合。
- ポイントの座標が不正で、ロケーターで使用される空間座標に変換できない場合。
- ロケーターがポイントと関連付けられる参照フィーチャをエリア内に保持していない場合。
- 妥当な距離内に適切な一致が存在しないフィーチャタイプが指定された場合。詳細については、フィーチャタイプの一致条件をご参照ください。
ロケータープロパティでリバース距離が指定されている場合、ロケーターでサポートされているロールに基づいて使用される、最適化された階層の距離値は、オーバーライドされます。
ArcGIS World Geocoding Service を使用してフィーチャクラスをリバースジオコーディングするには、ArcGIS Online 組織向けプランのサブスクリプションが必要です。
Z 対応データで構築された入力ロケーターを使用する場合、ツールは Z 対応でない出力を返します。このツールでは、2D 出力のみがサポートされています。

ラベル	説明	データタイプ
入力フィーチャクラスまたはレイヤー	フィーチャのポイント位置に基づいて、一致する場所または住所が返されるポイントフィーチャクラスまたはレイヤー。	Feature Layer
入力住所ロケーター	入力フィーチャクラスまたはレイヤーをリバースジオコーディングするために使用するロケーター。	Address Locator
出力フィーチャクラス	出力フィーチャクラス。注意: シェープファイルの制限のため、シェープファイル形式への出力の保存はサポートされていません。	Feature Class
出力住所タイプ (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。デフォルトでは、ロケーターでサポートされているフィーチャタイプが使用されます。	String
検索距離 (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。デフォルトでは、ロケーターでサポートされているロールに基づいて、最適化された階層の距離値が使用され、オーバーライドできません。	Linear Unit
フィーチャタイプ (オプション)	返される可能性がある一致タイプを指定します。単一または複数の値を指定できます。単一の値を指定した場合、入力フィーチャタイプの検索許容値は 500 メートルになります。複数の値が含まれる場合、フィーチャタイプの階層テーブルで指定されているデフォルトの検索距離が適用されます。リバースジオコーディングでのこのパラメーターの使用の詳細については、「フィーチャタイプ」をご参照ください。このパラメーターは、すべてのロケーターではサポートされていません。サブアドレス—一致は、家屋および建物のサブアドレスの位置を表すポイントに基づくストリート住所に制限されます。サービスとして公開される場合、ArcGIS Pro 2.8 以降および ArcGIS Enterprise 10.9 以降で作成されたロケーターがこのオプションには必要です。ポイント住所—一致は、家屋および建物の位置を表すポイントに基づくストリート住所に制限されます。パーセル—一致は、不動産として見なされ、1 軒以上の家屋やその他の構造物が含まれる土地区画に制限されます。このオプションでは、通常、住所とパーセル ID 番号が割り当てられます。このオプションは、パーセルロールを使用して構築されたカスタムロケーターでのみサポートされます。ArcGIS World Geocoding Service ロケーターと ArcGIS StreetMap Premium ロケーターではサポートされません。ストリート住所—一致は、番地がさまざまな数値から内挿されるため、ポイント住所とは異なるストリート住所に制限されます。ストリート住所の照合には、内挿された番地の値ではなく、一致するストリートセグメントの番地範囲が含まれます。ストリート交差点—一致は、ストリート交差点と市、州 (オプション)、および郵便番号で構成されるストリート住所に制限されます。これは、ストリート住所参照データから取得されます (Redlands Blvd & New York St, Redlands, CA, 92373 など)。ストリート名—一致は、ストリート住所に類似しているが、番地を含まず、行政区画および郵便番号 (オプション) を含むストリート住所 (W Olive Ave, Redlands, CA, 92373 など) に制限されます。ローカル—一致は、居住域を表す場所名に制限されます。郵便番号—一致は、郵便番号に制限されます。参照データは、郵便番号ポイントです (「90210 USA」など)。目標物—一致は、目標物に制限されます。参照データは、行政区画、場所名、ビジネス、ランドマーク、および地理フィーチャで構成されます (Starbucks など)。距離マーカー—一致は、指定された起点からの、道路に沿った直線距離 (通常は、キロメートルまたはマイル単位) を表すストリート住所 (Mile 25 I-5 N, San Diego, CA など) に制限されます。	String
優先位置タイプ (オプション)	`PointAddress` の一致で返される優先出力ジオメトリーを指定します。優先位置がデータに存在しない場合は、住所の位置のデフォルトの位置が返されます。 `geocodeAddresses` の `locationType` パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。住所の位置—屋根の位置、区画の重心、玄関などの住所位置を表すジオコード結果のジオメトリーが返されます。これがデフォルトです。ルート検索の位置—車両のルート検索に使用できる道路脇に近い位置を表すジオコード結果のジオメトリーを返します。	String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})

名前	説明	データタイプ
in_features	フィーチャのポイント位置に基づいて、一致する場所または住所が返されるポイントフィーチャクラスまたはレイヤー。	Feature Layer
in_address_locator	入力フィーチャクラスまたはレイヤーをリバースジオコーディングするために使用するロケーター。	Address Locator
out_feature_class	出力フィーチャクラス。注意: シェープファイルの制限のため、シェープファイル形式への出力の保存はサポートされていません。	Feature Class
address_type (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。デフォルトでは、ロケーターでサポートされているフィーチャタイプが使用されます。	String
search_distance (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。デフォルトでは、ロケーターでサポートされているロールに基づいて、最適化された階層の距離値が使用され、オーバーライドできません。	Linear Unit
feature_type [feature_type,...] (オプション)	返される可能性がある一致タイプを指定します。単一または複数の値を指定できます。単一の値を指定した場合、入力フィーチャタイプの検索許容値は 500 メートルになります。複数の値が含まれる場合、フィーチャタイプの階層テーブルで指定されているデフォルトの検索距離が適用されます。リバースジオコーディングでのこのパラメーターの使用の詳細については、「フィーチャタイプ」をご参照ください。このパラメーターは、すべてのロケーターではサポートされていません。 `SUBADDRESS`—一致は、家屋および建物のサブアドレスの位置を表すポイントに基づくストリート住所に制限されます。サービスとして公開される場合、ArcGIS Pro 2.8 以降および ArcGIS Enterprise 10.9 以降で作成されたロケーターがこのオプションには必要です。 `POINT_ADDRESS`—一致は、家屋および建物の位置を表すポイントに基づくストリート住所に制限されます。 `PARCEL`—一致は、不動産として見なされ、1 軒以上の家屋やその他の構造物が含まれる土地区画に制限されます。このオプションでは、通常、住所とパーセル ID 番号が割り当てられます。このオプションは、パーセルロールを使用して構築されたカスタムロケーターでのみサポートされます。ArcGIS World Geocoding Service ロケーターと ArcGIS StreetMap Premium ロケーターではサポートされません。 `STREET_ADDRESS`—一致は、番地がさまざまな数値から内挿されるため `POINT_ADDRESS` とは異なるストリート住所に制限されます。 `STREET_ADDRESS` の一致には、内挿された番地の値ではなく、一致するストリートセグメントの番地範囲が含まれます。 `STREET_INTERSECTION`—一致は、ストリート交差点と市、州 (オプション)、および郵便番号で構成されるストリート住所に制限されます。これは、`STREET_ADDRESS` 参照データから取得されます (Redlands Blvd & New York St, Redlands, CA, 92373 など)。 `STREET_NAME`—一致は、`STREET_ADDRESS` に類似しているが、番地を含まず、行政区画および郵便番号 (オプション) を含むストリート住所に制限されます (W Olive Ave, Redlands, CA, 92373 など)。 `LOCALITY`—一致は、居住域を表す場所名に制限されます。 `POSTAL`—一致は、郵便番号に制限されます。参照データは、郵便番号ポイントです (「90210 USA」など)。 `POINT_OF_INTEREST`—一致は、目標物に制限されます。参照データは、行政区画、場所名、ビジネス、ランドマーク、および地理フィーチャで構成されます (Starbucks など)。 `DISTANCE_MARKER`—一致は、指定された起点からの、道路に沿った直線距離 (通常は、キロメートルまたはマイル単位) を表すストリート住所 (Mile 25 I-5 N, San Diego, CA など) に制限されます。	String
location_type (オプション)	`PointAddress` の一致で返される優先出力ジオメトリーを指定します。優先位置がデータに存在しない場合は、`ADDRESS_LOCATION` のデフォルトの位置が返されます。 `geocodeAddresses` の `locationType` パラメーターの詳細については、ArcGIS REST API Web ヘルプをご参照ください。 `ADDRESS_LOCATION`—屋根の位置、区画の重心、玄関などの住所位置を表すジオコード結果のジオメトリーが返されます。これがデフォルトです。 `ROUTING_LOCATION`—車両のルート検索に使用できる道路脇に近い位置を表すジオコード結果のジオメトリーを返します。	String

コードのサンプル

ReverseGeocode の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードで ReverseGeocode 関数を使用する方法を示しています。

import arcpy

arcpy.env.workspace = "C:/data/locations.gdb"

# Set local variables:
input_feature_class = "customers"
address_locator = "e:/StreetMap/data/Street_Addresses_US.loc"
result_feature_class = "customers_with_address"

arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
                               result_feature_class, "ADDRESS")

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

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

# Description:
# Reverse Geocode customer point locations using a locator created with
# the Create Locator tool.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "c:/data/Atlanta/Atlanta_StreetAddress.loc"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

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

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

注意:

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

# Description:
# Reverse Geocode customer point locations using the ArcGIS World Geocoding Service.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

環境

出力座標系

ライセンス情報

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

リバース ジオコーディング (ジオコーディング ツール)

サマリー

注意:

使用法

パラメーター

注意:

レガシー:

レガシー:

環境

ライセンス情報

関連トピック

リバースジオコーディング (ジオコーディングツール)