Convertir notación de coordenadas (Gestión de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

Convierte notaciones de coordenadas presentes en uno o dos campos de un formato a otro.

Obtenga más información sobre formatos de notaciones compatibles

Uso

Sintaxis

ConvertCoordinateNotation_management (in_table, out_featureclass, x_field, y_field, input_coordinate_format, output_coordinate_format, {id_field}, {output_coordinate_system}, {in_coordinate_system})
ParámetroExplicaciónTipo de datos
in_table

La tabla que contiene los campos con notaciones de coordenadas a convertir.

Table View
out_featureclass

La clase de entidad de salida de puntos. La tabla de atributos contendrá todos los campos de la tabla de entrada junto con los campos que contienen los valores convertidos al formato de salida.

Feature Class
x_field

Un campo de la tabla de entrada que contiene el valor de longitud. Para DD_2, DD_NUMERIC, DDM_2 y DMS_2, este es el campo de longitud.

Para DD_1, DDM_1 y DMS_1, este campo contiene tanto los valores de latitud como de longitud en una sola cadena de caracteres.

Para GARS, GEOREF, UTM_ZONES, UTM_BANDS, USNG y MGRS, este campo contiene un sistema de notación alfanumérica en un solo campo de texto.

El parámetro y_field se ignora cuando se elige uno de los formatos de una sola cadena de caracteres.

Field
y_field

Un campo de la tabla de entrada que contiene el valor de longitud. Para DD_2, DD_NUMERIC, DDM_2 y DMS_2, este es el campo de longitud.

Para DD_1, DDM_1 y DMS_1, este campo contiene tanto los valores de latitud como de longitud en una sola cadena de caracteres.

Para GARS, GEOREF, UTM_ZONES, UTM_BANDS, USNG y MGRS, este campo contiene un sistema de notación alfanumérica en un solo campo de texto.

Este parámetro se ignora cuando se elige uno de los formatos de una sola cadena de caracteres.

Field
input_coordinate_format

Formato de las coordenadas en los campos de entrada. El valor predeterminado es DD_2.

  • DD_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DD_2Los valores de longitud y latitud se encuentran en dos campos separados.
  • DDM_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DDM_2 Los valores de longitud y latitud se encuentran en dos campos separados.
  • DMS_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DMS_2Los valores de longitud y latitud se encuentran en dos campos separados.
  • GARSSistema de referencia de área global. Se basa en la latitud y longitud, divide y subdivide el globo terráqueo en celdas.
  • GEOREFSistema de referencia geográfica mundial. Un sistema basado en cuadrículas que divide el globo terráqueo en cuadrángulos de 15 grados y después lo subdivide en cuadrángulos más pequeños.
  • UTM_ZONESLa letra N o S después del número de zona UTM indica hemisferio Norte o Sur.
  • UTM_BANDSLa letra después del número de zona UTM indica una de las 20 bandas de latitud. N o S no indica un hemisferio.
  • USNGCuadrícula nacional de Estados Unidos. Es casi exactamente lo mismo que MGRS pero utiliza el Datum de Norteamérica de 1983 (NAD83) como su datum.
  • MGRSSistema de Referencia de Cuadrícula Militar. Sigue las coordenadas UTM y divide el globo terráqueo en bandas de longitud de 6 grados y 20 bandas de latitud, pero MGRS además subdivide las zonas de cuadrículas en cuadrículas más pequeñas de 100.000 metros. Estas cuadrículas de 100.000 metros después se dividen en cuadrículas de 10.000 metros, 1.000 metros, 100 metros, 10 metros y 1 metro.
  • FORMASolo está disponible cuando se selecciona una capa de entidades de puntos como entrada. Las coordenadas de cada punto se utilizan para definir el formato de salida.

DD, DDM, DMS y UTM también son palabras clave válidas; se pueden utilizar con solo escribirlas (en diálogo) o introduciendo el valor en secuencia de comandos. Sin embargo, las palabras clave con guión bajo y un calificador aportan más información sobre los valores de campo.

String
output_coordinate_format

Formato de coordenadas para el que se convertirán las notaciones de entrada. El valor predeterminado es DD_2.

  • DD_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DD_2Los valores de longitud y latitud se encuentran en dos campos separados.
  • DD_NUMERICLos valores de longitud y latitud se encuentran en dos campos independientes de tipo Doble. Los valores en el Oeste y el Sur se indican mediante un signo menos, mientras que en DD_2, los valores están en texto y N, S, E y W se utilizan para indicar una dirección.
  • DDM_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DDM_2 Los valores de longitud y latitud se encuentran en dos campos separados.
  • DMS_1Ambos valores de longitud y latitud se encuentran en un campo único. Dos valores se separan por un espacio, una coma o una barra diagonal.
  • DMS_2Los valores de longitud y latitud se encuentran en dos campos separados.
  • GARSSistema de referencia de área global. Se basa en la latitud y longitud, divide y subdivide el globo terráqueo en celdas.
  • GEOREFSistema de referencia geográfica mundial. Un sistema basado en cuadrículas que divide el globo terráqueo en cuadrángulos de 15 grados y después lo subdivide en cuadrángulos más pequeños.
  • UTM_ZONESLa letra N o S después del número de zona UTM indica hemisferio Norte o Sur.
  • UTM_BANDSLa letra después del número de zona UTM indica una de las 20 bandas de latitud. N o S no indica un hemisferio.
  • USNGCuadrícula nacional de Estados Unidos. Es casi exactamente lo mismo que MGRS pero utiliza el Datum de Norteamérica de 1983 (NAD83) como su datum.
  • MGRSSistema de Referencia de Cuadrícula Militar. Sigue las coordenadas UTM y divide el globo terráqueo en bandas de longitud de 6 grados y 20 bandas de latitud, pero MGRS además subdivide las zonas de cuadrículas en cuadrículas más pequeñas de 100.000 metros. Estas cuadrículas de 100.000 metros después se dividen en cuadrículas de 10.000 metros, 1.000 metros, 100 metros, 10 metros y 1 metro.
  • FORMASolo está disponible cuando se selecciona una capa de entidades de puntos como entrada. Las coordenadas de cada punto se utilizan para definir el formato de salida.

DD, DDM, DMS y UTM también son palabras clave válidas; se pueden utilizar con solo escribirlas (en diálogo) o introduciendo el valor en secuencia de comandos. Sin embargo, las palabras clave con guión bajo y un calificador aportan más información sobre los valores de campo.

String
id_field
(Opcional)

HerenciaHerencia:

Este parámetro se ignora debido a que todos los campos que no pertenecen al sistema se transfieren a la tabla de salida.

Field
output_coordinate_system
(Opcional)

Referencia espacial de la clase de entidad de salida. El valor predeterminado es GCS_WGS_1984.

La herramienta proyecta la salida a la referencia espacial especificada. Si los sistemas de coordenadas de salida están en un datum distinto, se utiliza una transformación predeterminada basada en los sistemas de coordenadas de la entrada y la salida y la extensión de los datos.

Spatial Reference
in_coordinate_system
(Opcional)

Referencia espacial de los datos de entrada. Si no es posible obtener la referencia espacial de entrada a partir de la tabla de entrada, se utiliza el valor predeterminado GCS_WGS_1984.

Spatial Reference

Ejemplo de código

Ejemplo 1 de ConvertCoordinateNotation (secuencia de comandos independiente)

Uso de ConvertCoordinateNotation con un campo de formato de entrada.

# 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")
Ejemplo 2 de ConvertCoordinateNotation (secuencia de comandos independiente)

Formato de ConvertCoordinateNotation con dos campos de formato de entrada.

# 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])
Ejemplo 3 de ConvertCoordinateNotation (secuencia de comandos independiente)

Ejemplo de uso de ConvertCoordinateNotation con los formatos UTM_ZONES y UTM_BANDS.

# 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])
Ejemplo 4 de ConvertCoordinateNotation (secuencia de comandos independiente)

Ejemplo de ConvertCoordinateNotation que convierte los valores de grados decimales de texto de salida en valores de punto flotante. En lugar de S y O se utiliza un signo negativo.

# 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()

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014