座標表記の変換 (Convert Coordinate Notation) (データ管理ツール)

サマリー

1 つまたは 2 つのフィールドに含まれている座標表記の形式を変換します。

使用法

X フィールド (経度) および Y フィールド (緯度) の値に格納される値の座標系は、入力データの座標系 パラメーターで指定されます。入力テーブルがフィーチャクラスでない限り、デフォルトは GCS_WGS_1984 です。入力テーブルがフィーチャクラスである場合、デフォルトは入力フィーチャの座標系です。
以下の形式がサポートされています。
- 度 (10 進) (DD)
- 度分 (10 進) (DDM)
- 度分秒 (DMS)
- GARS (Global Area Reference System)
- GEOREF (World Geographic ReferenceSystem) および GEOREF 16
- ユニバーサル横メルカトル図法 (UTM)
- USNG (United States National Grid) および USNG 16
- MGRS (Military Grid Reference System) および MGRS 16
入力座標の形式 パラメーターのオプション DD 1、DDM 1、および DMS 1 の場合、緯度と経度の値は、連結されて単一のフィールドに格納される位置を表す必要があります。

DD 2、DDM 2、DMS 2 オプションの場合、緯度と経度の値は 2 つの異なるフィールドによって表されます。

DD 数値 オプションの場合、緯度と経度の値は double タイプの 2 つの異なるフィールドに格納されます。

GARS、GEOREF、GEOREF 16、UTM ゾーン、UTM バンド、USNG、USNG 16、MGRS、および MGRS 16 オプションの場合、値は単一文字列の座標形式です。これは、1 つのフィールドだけに座標が格納されることを意味しています。
入力座標の形式 および 出力座標の形式 パラメーターでは、MGRS 16 (例: 11SLT7858811533670379)、USNG 16、および Georef 16 オプションの精度 (16 桁) の方が、対応する MGRS (例: 11SLT78588115)、USNG、および GEOREF オプション (8 桁) よりも高くなります。
OID フィールドや入力形式フィールドを含め、入力テーブルのすべてのフィールドは、出力ポイントフィーチャクラスに移行されます。 OID フィールド値を使用すると、表記が無効なレコードを除外 パラメーターをオンにした場合に変換される有効な表記を区別できます。

出力フィールド名は、出力の座標表記の名前に一致します。たとえば、出力形式が MGRS の場合、新しい出力フィールド名は MGRS になります。

入力フィールドと同じ名前のフィールドが出力にすでに存在する場合、コピーされたフィールドの名前には一意の数字が追加されます。
表記が無効なレコードを除外 パラメーターをオフにすると、すべての入力レコードに関する情報が維持されます。 ジオメトリーのチェック ツールを使用して、表記が無効なレコードを識別できます。

表記が無効なレコードが存在する場合、ツールのメッセージに、すべての無効なレコードの ID が出力されたログファイルのパスが含まれます。
The XY 座標の追加 ツールを使用すると、-POINT_X と POINT_Y という 2 つのフィールドを出力ポイントフィーチャクラスに追加できます。これらのフィールドには、ポイントの座標が、フィーチャクラスの座標系の単位で入ります。
このツールは、DD、DMS、および DDM 形式の入力値に文字が含まれていない限り、数値表記 DD、DMS、および DDM を他の出力形式に変換することができます。

ラベル	説明	データタイプ
入力テーブル	入力テーブルまたはテキストファイル。ポイントフィーチャも有効です。	Table View
出力フィーチャクラス	出力ポイントフィーチャクラス。属性テーブルには、出力形式に変換された値を含むフィールドに加えて、入力テーブルのすべてのフィールドが含まれます。	Feature Class
X フィールド (経度)	経度の値を含む入力テーブルからのフィールド。入力座標の形式パラメーターの DD 2、DD 数値、DDM 2、および DMS 2 オプションの場合、これは経度フィールドになります。 DD 1、DDM 1、および DMS 1 オプションの場合、このフィールドには、緯度と経度の両方の値が単一の文字列形式で含まれます。 GARS、GEOREF、GEOREF 16、UTM ゾーン、UTM バンド、USNG、USNG 16、MGRS、および MGRS 16 オプションの場合、このフィールドでは、1 つのテキストフィールドに英数字表記が含まれます。	Field
Y フィールド (緯度)	緯度の値を含む入力テーブルからのフィールド。入力座標の形式パラメーターの DD 2、DD 数値、DDM 2、および DMS 2 オプションの場合、これは緯度フィールドになります。 1 列フォーマットの 1 つを選択すると、このパラメーターは非アクティブになります。	Field
入力座標の形式	入力フィールドの座標形式を指定します。 DD、DDM、DMS、UTM も有効なキーワードであり、ダイアログボックスに入力するか、スクリプト内で値を渡して使用できます。ただし、アンダースコアと修飾子を含むキーワードは、フィールド値に関する追加情報を示します。 DD 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DD 2—経度と緯度の値が 2 つの個別のフィールドに入っています。これがデフォルトです。 DDM 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DDM 2—経度と緯度の値が 2 つの個別のフィールドに入っています。 DMS 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DMS 2—経度と緯度の値が 2 つの個別のフィールドに入っています。 GARS—GARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。 GEOREF—WGRS (World Geographic Reference System) はグリッドベースのシステムで、世界を 15 度の図幅に分割し、それらをさらに小さな図幅に分割します。 GEOREF 16—World Geographic Reference System (16 桁の精度)。 UTM ゾーン—UTM ゾーン番号の後ろにある文字 N または S は、北半球または南半球を示します。 UTM バンド—UTM ゾーン番号の後ろにある文字は、20 の緯度帯のいずれかを示します。 N または S は半球を示しません。 USNG—United States National Grid は MGRS とほぼ同じですが、測地基準系として NAD83 (北米測地基準系 1983) を使用しています。 USNG 16—United States National Grid (16 桁の高精度) MGRS—Military Grid Reference System は UTM 座標を採用し、世界を 6 度の経度帯と 20 の緯度帯に分割しますが、MGRS はさらにグリッドゾーンを 100,000 メートルの小さなグリッドに細分化します。これらの 100,000 メートルグリッドは、さらに 10,000 メートル、1,000 メートル、100 メートル、10 メートル、1 メートルのグリッドに分割されます。 MGRS 16—Military Grid Reference System (16 桁の精度) 形状—ポイントフィーチャレイヤーが入力として選択された場合のみ使用できます。各地点の座標は出力形式を定義するために使用されます。	String
出力座標の形式	入力表記が変換される座標形式を指定します。 DD、DDM、DMS、UTM も有効なキーワードであり、ダイアログボックスに入力するか、スクリプト内で値を渡して使用できます。ただし、アンダースコアと修飾子を含むキーワードは、フィールド値に関する追加情報を示します。 DD 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DD 2—経度と緯度の値が 2 つの個別のフィールドに入っています。 DD 数値—経度と緯度の値が double タイプの 2 つのフィールドに入っています。西と南の値はマイナス記号で示されます。 DDM 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DDM 2—経度と緯度の値が 2 つの個別のフィールドに入っています。 DMS 1—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 DMS 2—経度と緯度の値が 2 つの個別のフィールドに入っています。 GARS—GARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。 GEOREF—WGRS (World Geographic Reference System) はグリッドベースのシステムで、世界を 15 度の図幅に分割し、それらをさらに小さな図幅に分割します。 GEOREF 16—World Geographic Reference System (16 桁の精度)。 UTM ゾーン—UTM ゾーン番号の後ろにある文字 N または S は、北半球または南半球を示します。 UTM バンド—UTM ゾーン番号の後ろにある文字は、20 の緯度帯のいずれかを示します。 N または S は半球を示しません。 USNG—United States National Grid は MGRS とほぼ同じですが、測地基準系として NAD83 (北米測地基準系 1983) を使用しています。 USNG 16—United States National Grid (16 桁の高精度) MGRS—Military Grid Reference System は UTM 座標を採用し、世界を 6 度の経度帯と 20 の緯度帯に分割しますが、MGRS はさらにグリッドゾーンを 100,000 メートルの小さなグリッドに細分化します。これらの 100,000 メートルグリッドは、さらに 10,000 メートル、1,000 メートル、100 メートル、10 メートル、1 メートルのグリッドに分割されます。 MGRS 16—Military Grid Reference System (16 桁の精度)	String
ID (オプション)	すべてのフィールドが出力テーブルに転送されるため、このパラメーターは現在使用されていません。	Field
出力座標系 (オプション)	出力フィーチャクラスの空間参照。デフォルトは GCS_WGS_1984 です。このツールは、指定された空間参照に出力を投影します。入力および出力座標系の測地基準系が異なる場合、入力および出力の座標系とデータの範囲に基づいて、デフォルトの変換が使用されます。	Spatial Reference
入力データの座標系 (オプション)	入力データの空間参照。入力テーブルから入力空間参照を取得できない場合は、デフォルトの GCS_WGS_1984 が使用されます。	Coordinate System
表記が無効なレコードを除外 (オプション)	表記が無効なレコードを除外するかどうかを指定します。オン—無効なレコードが除外され、有効なレコードのみが出力でポイントに変換されます。これがデフォルトです。オフ—有効なレコードが出力でポイントに変換され、無効なレコードは NULL ジオメトリとして含まれます。	Boolean

arcpy.management.ConvertCoordinateNotation(in_table, out_featureclass, x_field, y_field, input_coordinate_format, output_coordinate_format, {id_field}, {spatial_reference}, {in_coor_system}, {exclude_invalid_records})

名前	説明	データタイプ
in_table	入力テーブルまたはテキストファイル。ポイントフィーチャも有効です。	Table View
out_featureclass	出力ポイントフィーチャクラス。属性テーブルには、出力形式に変換された値を含むフィールドに加えて、入力テーブルのすべてのフィールドが含まれます。	Feature Class
x_field	経度の値を含む入力テーブルからのフィールド。 `input_coordinate_format` パラメーターの `DD_2`、`DD_NUMERIC`、`DDM_2`、および `DMS_2` オプションの場合、これは経度フィールドになります。 `DD_1`、`DDM_1`、および `DMS_1` オプションの場合、このフィールドには、緯度と経度の両方の値が単一の文字列形式で含まれます。 `GARS`、`GEOREF`、`GEOREF16`、`UTM_ZONES`、`UTM_BANDS`、`USNG`、`USNG16`、`MGRS`、`MGRS16` の各オプションでは、このフィールドでは、1 つのテキストフィールドに英数字表記が含まれます。	Field
y_field	緯度の値を含む入力テーブルからのフィールド。 `input_coordinate_format` パラメーターの `DD_2`、`DD_NUMERIC`、`DDM_2`、および `DMS_2` オプションの場合、これは経度フィールドになります。 1 列フォーマットの 1 つを選択すると、このパラメーターは無視されます。	Field
input_coordinate_format	入力フィールドの座標形式を指定します。 DD、DDM、DMS、UTM も有効なキーワードであり、ダイアログボックスに入力するか、スクリプト内で値を渡して使用できます。ただし、アンダースコアと修飾子を含むキーワードは、フィールド値に関する追加情報を示します。 `DD_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DD_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。これがデフォルトです。 `DDM_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DDM_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。 `DMS_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DMS_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。 `GARS`—GARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。 `GEOREF`—WGRS (World Geographic Reference System) はグリッドベースのシステムで、世界を 15 度の図幅に分割し、それらをさらに小さな図幅に分割します。 `GEOREF16`—World Geographic Reference System (16 桁の精度)。 `UTM_ZONES`—UTM ゾーン番号の後ろにある文字 N または S は、北半球または南半球を示します。 `UTM_BANDS`—UTM ゾーン番号の後ろにある文字は、20 の緯度帯のいずれかを示します。 N または S は半球を示しません。 `USNG`—United States National Grid は MGRS とほぼ同じですが、測地基準系として NAD83 (北米測地基準系 1983) を使用しています。 `USNG16`—United States National Grid (16 桁の高精度) `MGRS`—Military Grid Reference System は UTM 座標を採用し、世界を 6 度の経度帯と 20 の緯度帯に分割しますが、MGRS はさらにグリッドゾーンを 100,000 メートルの小さなグリッドに細分化します。これらの 100,000 メートルグリッドは、さらに 10,000 メートル、1,000 メートル、100 メートル、10 メートル、1 メートルのグリッドに分割されます。 `MGRS16`—Military Grid Reference System (16 桁の精度) `SHAPE`—ポイントフィーチャレイヤーが入力として選択された場合のみ使用できます。各地点の座標は出力形式を定義するために使用されます。	String
output_coordinate_format	入力表記が変換される座標形式を指定します。 DD、DDM、DMS、UTM も有効なキーワードであり、ダイアログボックスに入力するか、スクリプト内で値を渡して使用できます。ただし、アンダースコアと修飾子を含むキーワードは、フィールド値に関する追加情報を示します。 `DD_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DD_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。 `DD_NUMERIC`—経度と緯度の値が double タイプの 2 つのフィールドに入っています。西と南の値はマイナス記号で示されます。 `DDM_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DDM_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。 `DMS_1`—経度と緯度の値が両方とも 1 つのフィールドに入っています。 2 つの値はスペース、カンマ、またはスラッシュで区切られます。 `DMS_2`—経度と緯度の値が 2 つの個別のフィールドに入っています。 `GARS`—GARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。 `GEOREF`—WGRS (World Geographic Reference System) はグリッドベースのシステムで、世界を 15 度の図幅に分割し、それらをさらに小さな図幅に分割します。 `GEOREF16`—World Geographic Reference System (16 桁の精度)。 `UTM_ZONES`—UTM ゾーン番号の後ろにある文字 N または S は、北半球または南半球を示します。 `UTM_BANDS`—UTM ゾーン番号の後ろにある文字は、20 の緯度帯のいずれかを示します。 N または S は半球を示しません。 `USNG`—United States National Grid は MGRS とほぼ同じですが、測地基準系として NAD83 (北米測地基準系 1983) を使用しています。 `USNG16`—United States National Grid (16 桁の高精度) `MGRS`—Military Grid Reference System は UTM 座標を採用し、世界を 6 度の経度帯と 20 の緯度帯に分割しますが、MGRS はさらにグリッドゾーンを 100,000 メートルの小さなグリッドに細分化します。これらの 100,000 メートルグリッドは、さらに 10,000 メートル、1,000 メートル、100 メートル、10 メートル、1 メートルのグリッドに分割されます。 `MGRS16`—Military Grid Reference System (16 桁の精度)	String
id_field (オプション)	すべてのフィールドが出力テーブルに転送されるため、このパラメーターは無視されます。	Field
spatial_reference (オプション)	出力フィーチャクラスの空間参照。デフォルトは GCS_WGS_1984 です。このツールは、指定された空間参照に出力を投影します。入力および出力座標系の測地基準系が異なる場合、入力および出力の座標系とデータの範囲に基づいて、デフォルトの変換が使用されます。	Spatial Reference
in_coor_system (オプション)	入力データの空間参照。入力テーブルから入力空間参照を取得できない場合は、デフォルトの GCS_WGS_1984 が使用されます。	Coordinate System
exclude_invalid_records (オプション)	表記が無効なレコードを除外するかどうかを指定します。 `EXCLUDE_INVALID`—無効なレコードが除外され、有効なレコードのみが出力でポイントに変換されます。これがデフォルトです。 `INCLUDE_INVALID`—有効なレコードが出力でポイントに変換され、無効なレコードは NULL ジオメトリとして含まれます。	Boolean

コードのサンプル

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

次のスタンドアロンスクリプトは、1 つの入力形式フィールドを含む ConvertCoordinateNotation 関数の使用方法を示しています。

# import arcpy module
import arcpy

# set locals variables
in_tab = r"c:\data\notation.gdb\loc_mgrs"
out_pts = r"c:\data\notation.gdb\loc_final"

# call Convert Coordinate Notation with MGRS as input field.
# leaving out spatial reference parameter will default to WGS 1984
arcpy.management.ConvertCoordinateNotation(in_tab, out_pts, "m10d", "#", "MGRS", "DD_1")

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

次のスタンドアロンスクリプトは、2 つの入力形式フィールドを含む ConvertCoordinateNotation 関数の使用方法を示しています。

# imports
import arcpy

arcpy.env.workspace = r"c:\data\mtf.gdb"

# set parameter values
input_table = 'rit_up_DD'
output_points = 'ritLOC'
x_field = 'LON'
y_field = 'LAT'
input_format = 'DD_2'
output_format = 'GARS'
id_field = 'CITY_NAME'
spatial_ref = arcpy.SpatialReference('WGS 1984')

try:
    arcpy.management.ConvertCoordinateNotation(input_table, output_points, x_field, y_field,
                                               input_format, output_format, id_field, spatial_ref)
    print(arcpy.GetMessages(0))

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as ex:
    print(ex.args[0])

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

次のスタンドアロンスクリプトは、UTM_ZONES 形式と UTM_BANDS 形式を含む ConvertCoordinateNotation 関数の使用方法を示しています。

# imports
import arcpy

arcpy.env.workspace = r"c:\data\ccn.gdb"

# export_utm58 table contains coordinates in UTM_BANDS format
# where N and S indicate latitude bands,
# for example, 58S4144921393176 - here 58S is latitude band
input_table = 'export_utm58'

# the coordinate values in output point table will be in UTM_ZONES format
# for example, 58N4144921393176 - note that it is now 58N because
# the point is in UTM 58 North zone
output_points = 'utm_zone18'

spatial_ref = arcpy.SpatialReference('WGS 1984')

try:
    arcpy.management.ConvertCoordinateNotation(input_table, output_points, "LOCS", "",
                                               "UTM_BANDS", "UTM_ZONES", "", spatial_ref)
    print(arcpy.GetMessages(0))

except Exception as ex:
    print(ex.args[0])

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

次のスタンドアロンスクリプトは、出力テキストの 10 進度値を浮動小数点値に変換するための ConvertCoordinateNotation 関数の使用方法を示しています。 S および W の代わりに、マイナス記号が使用されることに注意してください。

# imports
import arcpy

# output from Convert Coordinate Notation tool
# for DD_2 (and also for DD_1) format, the output values are in string format
# for example, for DD_1, the output values may be '43.63872N 116.24135W'
in_table = r"c:\data\ccn.gdb\ccn_dd1"

# add a field of type DOUBLE to store the numeric longitude value
arcpy.management.AddField(in_table, "DDLonDbl", "DOUBLE")

# now call CalculateField tool to convert the values, 'W' is negative
expr = """def convertToDouble(fldval):
    val = float(fldval[:-1])
    if fldval[-1:] == 'W':
        return val * -1.0
    else:
        return val"""
try:
    # DDLon field contains longitudes in a string field
    arcpy.management.CalculateField(in_table, "DDLonDbl",  "convertToDouble(!DDLon!)", "PYTHON_9.3", expr)
except:
    print(arcpy.GetMessages())

# add another field to store the numeric longitude value
arcpy.management.AddField(in_table, "DDLatDbl", "DOUBLE")

# call CalculateField again to convert the values, 'S' is negative
expr = """def convertToDouble(fldval):
    val = float(fldval[:-1])
    if fldval[-1:] == 'S':
        return val * -1.0
    else:
        return val"""

try:
    # DDLat field contains latitudes in a string field
    arcpy.management.CalculateField(in_table, "DDLatDbl", "convertToDouble(!DDLat!)", "PYTHON_9.3", expr)
except:
    print(arcpy.GetMessages())

環境

スクラッチワークスペース, 現在のワークスペース, 出力座標系, 地理座標系変換, XY 許容値

ライセンス情報

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

座標表記の変換 (Convert Coordinate Notation) (データ管理ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック