ラベル | 説明 | データ タイプ |
入力フィーチャクラスまたはレイヤー | フィーチャのポイント位置に基づいて、一致する場所または住所が返されるポイント フィーチャクラスまたはレイヤー。 | Feature Layer |
入力住所ロケーター | 入力フィーチャクラスまたはレイヤーをリバース ジオコーディングするために使用するロケーター。 | Address Locator |
出力フィーチャクラス | 出力フィーチャクラス。 注意:「シェープファイルの制限」のため、シェープファイル形式への出力の保存はサポートされていません。 | Feature Class |
出力住所タイプ (オプション) |
レガシー:このパラメーターは非推奨であり、下位互換性のみのために維持されています。 デフォルトでは、ロケーターでサポートされているフィーチャ タイプが使用されます。 | String |
検索距離 (オプション) |
レガシー:このパラメーターは非推奨であり、下位互換性のみのために維持されています。 デフォルトでは、ロケーターでサポートされているロールに基づいて、最適化された「階層の距離値」が使用され、オーバーライドできません。 | Linear Unit |
フィーチャ タイプ (オプション) | 返される可能性がある一致タイプを指定します。 単一または複数の値を選択できます。 単一の値を選択した場合、入力フィーチャ タイプの検索許容値は 500 メートルです。 複数の値が含まれる場合、フィーチャ タイプの「階層テーブル」で指定されているデフォルトの検索距離が適用されます。 リバース ジオコーディングの [フィーチャ タイプ] パラメーターの詳細については、「フィーチャ タイプ」をご参照ください。 すべてのロケーターがこのパラメーターに対応しているわけではありません。
| String |
優先位置タイプ (オプション) | [ポイント住所] の照合で返される優先出力ジオメトリを指定します。 このパラメーターのオプションは、ルート検索に使用できる道路の片側の位置か、屋上や住所の区画の重心を表す位置です。 優先位置がデータに存在しない場合、デフォルト位置が返されます。 Addr_type=PointAddress のジオコード結果の場合、x および y 属性値は道路に沿った住所の座標を記述し、DisplayX および DisplayY の値は屋上または建物の重心の座標を記述します。 すべてのロケーターがこのパラメーターに対応しているわけではありません。
| String |
サマリー
フィーチャクラスのポイント位置から住所を生成します。 リバース ジオコーディング処理により、[ロケーターの作成 (Create Locator)] ツールで作成したロケーターの最適化された距離値に基づいて、ポイント位置に最も近い住所、場所または交差点を検索します。
ArcGIS World Geocoding Service を使用してジオコーディング操作を行う場合は、ArcGIS 組織アカウントが必要であり、クレジットが消費されます。 ジオコーディング リクエストを最後まで完了するには、組織アカウントに十分なクレジットが必要です。
注意:
アクティブなポータルが ArcGIS Online で、入力ロケーターが ArcGIS World Geocoding Service の場合、クレジットの推定はツールの上部に表示されます。
使用法
入力フィーチャクラスには、有効な XY 座標を持つポイント形状が必要です。 NULL 座標のポイントでは結果は返されません。
出力フィーチャクラスには入力フィーチャクラスと同数のレコードが含まれます。 住所または場所の検索結果を含むフィールドがフィーチャクラスに追加されます。 フィールド名は REV_ で始まります。 一致する場所または住所を検索できない場合、フィールドは空の値になります。
入力フィーチャクラスの空間参照がロケーターと異なる場合、ロケーターはリアルタイムに座標を変換して一致の検索を試みます。 出力フィーチャクラスは入力フィーチャクラスと同じ空間参照内に保存されます。 出力フィーチャクラスの空間参照を変更するには、ツールの「環境設定」で異なる「出力座標系」を設定します。
入力フィーチャクラスのポイントで、一致する場所または住所が返されない場合、入力ポイントに関連付けられるフィーチャがロケーター内に存在しないことを意味します。 ポイントが一致しない一般的な原因は、次のとおりです。
- ポイントが NULL 座標を含んでいる場合。
- ポイントの座標が不正で、ロケーターで使用される空間座標に変換できない場合。
- ロケーターがポイントと関連付けられる参照フィーチャをエリア内に保持していない場合。
- 妥当な距離内に適切な一致が存在しないフィーチャ タイプが指定された場合。 詳細については、「フィーチャ タイプの一致条件」をご参照ください。
ArcGIS World Geocoding Service を使用してフィーチャクラスをリバース ジオコーディングするには、ArcGIS Online 組織向けプラン サブスクリプションが必要です。
Z 対応データで構築された入力ロケーターを使用する場合、ツールは Z 対応でない出力を返します。 このツールでは、2D 出力のみがサポートされています。
パラメーター
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 メートルです。 複数の値が含まれる場合、フィーチャ タイプの「階層テーブル」で指定されているデフォルトの検索距離が適用されます。 リバース ジオコーディングの feature_type パラメーターの詳細については、「フィーチャ タイプ」をご参照ください。 すべてのロケーターがこのパラメーターに対応しているわけではありません。
| String |
location_type (オプション) | POINT_ADDRESS の照合で返される優先出力ジオメトリを指定します。 このパラメーターのオプションは、ルート検索に使用できる道路の片側の位置を表す ROUTING_LOCATION または屋上、住所の区画の重心、玄関を表す ADDRESS_LOCATION です。 優先位置がデータに存在しない場合、ROUTING_LOCATION のデフォルト位置が返されます。 Addr_type=PointAddress のジオコード結果の場合、x および y 属性値は道路に沿った住所の座標を記述し、DisplayX および DisplayY の値は屋上または建物の重心の座標を記述します。 「reverseGeocode の locationType パラメーター」の詳細については、REST API Web ヘルプをご参照ください。 すべてのロケーターがこのパラメーターに対応しているわけではありません。
| String |
コードのサンプル
次の 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")
次の 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)
次の 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: Yes
- Standard: Yes
- Advanced: Yes