Convertir notación de coordenadas (Administración de datos)
Resumen
Convierte notaciones de coordenadas que representan ubicaciones de un formato a otro.
Obtenga más información sobre formatos de notaciones compatibles
Uso
La tabla de entrada puede ser un archivo de texto o cualquier tabla compatible con ArcGIS.
La salida es una clase de entidad de puntos en la que cada ubicación de entrada con una notación válida se representa como un punto. Los registros con notaciones no válidas no tendrán ninguna geometría y los campos de salida recién agregados estarán vacíos.
Los Id. de los registros con notaciones no válidas que no se hayan podido convertir se enumeran en un archivo de texto llamado ConvertCoordinateNotation<x>.log (<x> es un número arbitrario). El archivo se almacena en la carpeta Temp del usuario. Por ejemplo, en Windows 7, el directorio es Users\<usuario>\AppData\Local\Temp. En los sistemas UNIX, el archivo se encuentra en el directorio de inicio del usuario, en $TMP.
Son compatibles los siguientes formatos:
- Grados decimales (DD)
- Grados minutos en formato decimal (DDM)
- Grados-minutos-segundos (DMS)
- Sistema de referencia de área global (GARS)
- GEOREF (Sistema de referencia geográfica mundial)
- Proyección universal transversal de Mercator (UTM)
- Cuadrícula nacional de Estados Unidos (USNG)
- Sistema de Referencia de Cuadrícula Militar de EE.UU. (MGRS)
Se puede utilizar cualquier formato como el formato de entrada o de salida. Por ejemplo, DMS se puede utilizar como el formato de entrada y de salida para convertir valores y obtener una clase de entidad de puntos para las ubicaciones.
DD_1, DDM_1 y DMS_1 requieren dos valores para representar una ubicación: uno para la latitud y otro para la longitud. Los dos valores se concatenan en una sola cadena de caracteres y se almacenan en un único campo.
Para DD_2, DDM_2 y DMS_2, los valores de la latitud y la longitud se representan mediante dos campos independientes.
GARS, GEOREF, UTM, USNG y MGRS son formatos de coordenadas de una sola cadena, es decir, únicamente un campo contiene la coordenada.
Consulte la explicación del parámetro Formato de coordenadas de entrada a continuación para obtener más información.
Todos los campos de la tabla de entrada que no pertenecen al sistema, incluidos los campos de formato de entrada, se transfieren a la clase de entidad de puntos de salida.
Los nombres de campo de salida coinciden con el nombre de la notación de coordenadas de salida. Por ejemplo, si el formato de salida es MGRS, entonces el nuevo nombre de campo de salida será MGRS.
Si en la salida ya existe un campo con el mismo nombre que el campo de entrada, el nombre del campo copiado se incorpora con un número único.
La herramienta Agregar coordenadas XY se puede utilizar para agregar dos campos, POINT_X y POINT_Y, a la clase de entidad de puntos de salida. Estos campos contienen las coordenadas de un punto en la unidad del sistema de coordenadas de la clase de entidad.
Sintaxis
Parámetro | Explicación | Tipo 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, DDM_2 y DMS_2, este es el campo de longitud. Para DD_1, DDM_1, DMS_1, GARS, GEOREF, UTM, USNG y MGRS, este es el campo que contiene la latitud y la longitud. | Field |
y_field |
Un campo de la tabla de entrada que contiene el valor de latitud. Para DD_2, DDM_2 y DMS_2, este es el campo de latitud. Este parámetro se ignora para DD_1, DDM_1, DMS_1, GARS, GEOREF, UTM, USNG y MGRS. | Field |
input_coordinate_format |
Formato de las coordenadas en los campos de entrada. El valor predeterminado es DD_2.
DD, DDM y DMS 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 número indican si los valores provienen de un campo o dos campos. | String |
output_coordinate_format |
Formato de coordenadas para el que se convertirán las notaciones de entrada. El valor predeterminado es DD_2.
DD, DDM y DMS 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 número indican si los valores provienen de un campo o dos campos. | String |
id_field (Opcional) |
Cualquier campo de la tabla de entrada. El campo seleccionado se copiará en la tabla de salida. Si los valores de este campo son únicos, este se puede utilizar para unir los registros de salida a la tabla de entrada. | Field |
spatial_reference (Opcional) |
Referencia espacial de la clase de entidad de puntos de salida. El valor predeterminado es GCS_WGS_1984. Si la salida tiene un sistema de coordenadas diferente que la entrada, entonces la herramienta proyecta los datos. Si la entrada y la salida están en un datum distinto, entonces se calcula una transformación predeterminada basándose en los sistemas de coordenadas de la entrada y la salida y la extensión de los datos. | Spatial Reference |
Ejemplo de código
Uso de ConvertCoordinateNotation con un campo de formato de entrada.
#Imports
import arcpy
#Locals
in_tab = r"c:\workspace\inmed.gdb\loc_mgrs"
out_pts = r"c:\workspace\inmed.gdb\loc_final"
#Convert Coordinate Notation with MGRS as input field.
arcpy.ConvertCoordinateNotation_management(in_tab,out_pts,"m10d","#","MGRS","DD_1")
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])