转换坐标记法 (Data Management)

许可等级:BasicStandardAdvanced

摘要

将一个或两个字段包含的坐标记法从一种注记格式转换为另一种注记格式。

了解有关受支持的记法格式的详细信息

用法

语法

ConvertCoordinateNotation_management (in_table, out_featureclass, x_field, y_field, input_coordinate_format, output_coordinate_format, {id_field}, {output_coordinate_system}, {in_coordinate_system})
参数说明数据类型
in_table

包含具有要转换坐标记法的字段的表。

Table View
out_featureclass

点的输出要素类。属性表将包括输入表的所有字段以及以输出格式表示的转换值的字段。

Feature Class
x_field

输入表中包含经度值的字段。对于 DD_2、DD_NUMERIC、DDM_2 和 DMS_2,此字段即为经度字段。

对于 DD_1、DDM_1 和 DMS_1 格式,此字段包含单个字符串中的纬度值和经度值。

对于 GARS、GEOREF、UTM_ZONES、UTM_BANDS、USNG 和 MGRS,此字段包含单个文本字段中的字母数字记法系统。

选择其中一种单字符串格式时,y_field 参数将被忽略。

Field
y_field

输入表中包含经度值的字段。对于 DD_2、DD_NUMERIC、DDM_2 和 DMS_2,此字段即为经度字段。

对于 DD_1、DDM_1 和 DMS_1 格式,此字段包含单个字符串中的纬度值和经度值。

对于 GARS、GEOREF、UTM_ZONES、UTM_BANDS、USNG 和 MGRS,此字段包含单个文本字段中的字母数字记法系统。

选择其中一种单字符串格式时,此参数将被忽略。

Field
input_coordinate_format

输入字段的坐标格式。默认格式为 DD_2。

  • DD_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DD_2经度值和纬度值位于两个不同的字段中。
  • DDM_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DDM_2 经度值和纬度值位于两个不同的字段中。
  • DMS_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DMS_2经度值和纬度值位于两个不同的字段中。
  • GARS全球区域参考系。根据纬度和经度,该参考系将世界划分成大量的格网单元。
  • GEOREF世界地理参考系。一个基于格网的参考系统,将世界划分成 15 度的地图方格,然后再细分成更小的地图方格。
  • UTM_ZONESUTM 带编号后的字母 N 或 S 仅用于指定北半球或南半球。
  • UTM_BANDSUTM 带编号后的字母用于指定 20 个纬度带之一。N 或 S 不用于指定半球。
  • USNG美国国家格网。与 MGRS 几乎完全相同,但其基准面采用的是北美洲基准面 1983 (NAD83)。
  • MGRS军事格网参考系。按照 UTM 坐标,将世界划分成 6 度的经度带和 20 个纬度带,但 MGRS 将这些格网区域进一步划分成更小的 100,000 米格网。这些 100,000 米的格网再被细分成 10,000 米、1,000 米、100 米、10 米 和 1 米格网。
  • SHAPE仅在选择点要素图层作为输入时可用。每个点的坐标都用于定义输出格式。

DD、DDM、DMS 和 UTM 也是有效关键字;可通过(在对话框中)直接输入或在脚本中传递值的方式来使用这些关键字。但是,带下划线和限定符的关键字包含更多有关字段值的信息。

String
output_coordinate_format

输入记法转换后的坐标格式。默认格式为 DD_2。

  • DD_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DD_2经度值和纬度值位于两个不同的字段中。
  • DD_NUMERIC经度值和纬度值位于两个不同的“双精度”类型字段中。“西”部和“南”部的值以减号表示,而在 DD_2 中,各值以文本表示,N、S、E 和 W 用于表示方向。
  • DDM_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DDM_2 经度值和纬度值位于两个不同的字段中。
  • DMS_1经度值和纬度值位于同一个字段。两个值之间用空格、逗号或斜线进行分隔。
  • DMS_2经度值和纬度值位于两个不同的字段中。
  • GARS全球区域参考系。根据纬度和经度,该参考系将世界划分成大量的格网单元。
  • GEOREF世界地理参考系。一个基于格网的参考系统,将世界划分成 15 度的地图方格,然后再细分成更小的地图方格。
  • UTM_ZONESUTM 带编号后的字母 N 或 S 仅用于指定北半球或南半球。
  • UTM_BANDSUTM 带编号后的字母用于指定 20 个纬度带之一。N 或 S 不用于指定半球。
  • USNG美国国家格网。与 MGRS 几乎完全相同,但其基准面采用的是北美洲基准面 1983 (NAD83)。
  • MGRS军事格网参考系。按照 UTM 坐标,将世界划分成 6 度的经度带和 20 个纬度带,但 MGRS 将这些格网区域进一步划分成更小的 100,000 米格网。这些 100,000 米的格网再被细分成 10,000 米、1,000 米、100 米、10 米 和 1 米格网。
  • SHAPE仅在选择点要素图层作为输入时可用。每个点的坐标都用于定义输出格式。

DD、DDM、DMS 和 UTM 也是有效关键字;可通过(在对话框中)直接输入或在脚本中传递值的方式来使用这些关键字。但是,带下划线和限定符的关键字包含更多有关字段值的信息。

String
id_field
(可选)

法律声明法律声明:

由于所有的非系统字段都被传输到输出表,因此忽略此参数。

Field
output_coordinate_system
(可选)

输出要素类的空间参考。默认值为 GCS_WGS_1984。

此工具将输出投影到指定的空间参考中。如果输入坐标系和输出坐标系具有不同的基准面,则将根据输入坐标系和输出坐标系以及数据范围使用默认转换。

Spatial Reference
in_coordinate_system
(可选)

输入数据的空间参考。如果无法从输入表中获取输入空间参考,则使用默认值 GCS_WGS_1984。

Spatial Reference

代码实例

ConvertCoordinateNotation 示例 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.ConvertCoordinateNotation_management(in_tab, out_pts, "m10d", "#", "MGRS", "DD_1")
ConvertCoordinateNotation 示例 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.ConvertCoordinateNotation_management(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.ConvertCoordinateNotation_management(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(独立脚本)

将输出文本十进制度值转换为浮点值的 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.AddField_management(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.CalculateField_management(in_table,"DDLonDbl","convertToDouble(!DDLon!)","PYTHON_9.3",expr)
except:
    print arcpy.GetMessages()

    
# add another field to store the numeric longitude value
arcpy.AddField_management(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.CalculateField_management(in_table,"DDLatDbl","convertToDouble(!DDLat!)","PYTHON_9.3",expr)
except:
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014