Конвертировать обозначения координат (Convert Coordinate Notation) (Управление данными)
Резюме
Конвертация координатных обозначений, представляющих положения, из одного часового пояса в другой.
Использование
Входная таблица может быть текстовым файлом или любой таблицей, которая поддерживается ArcGIS.
Выходной класс объектов представляют собой класс точечных объектов, где каждое входное положение с допустимым обозначением представлено в виде точки. Записи, содержащие недопустимые обозначения, не содержат геометрии, и вновь добавленные выходные поля будут пустыми.
Идентификаторы записей, содержащих недопустимые обозначения, которые не удается конвертировать, представлены в текстовом файле с именем ConvertCoordinateNotation<x>.log (<x> является произвольным числом). Пространство имен хранится в папке Temp. Например, в Windows 7 используется каталог Users\<user>\AppData\Local\Temp. В системах UNIX файл расположен в домашней директории пользователя в разделе $TMP.
Поддерживаются следующие форматы:
- DD (десятичные градусы)
- Градусы с десятичными минутами (DDM)
- градусы-минуты-секунды (DMS)
- Справочная система глобальной области (GARS)
- GEOREF – Мировая географическая система привязки (World Geographic Reference System)
- Универсальная поперечная Меркатора (UTM)
- United States National Grid (USNG)
- Военная система прямоугольных координат (MGRS)
В качестве формата входных или выходных данных можно использовать любой формат. Например, DMS можно использовать как формат входных и выходных данных для конвертации значений и получения класса точечных объектов для положений.
DD_1,DDM_1 и DMS_1 предполагают для представления положения использовать два значения: одно отражает широту, а второе – долготу. Эти два значения связаны в одной строке и хранятся в одном поле.
Для DD_2, DDM_2 и DMS_2 значения широты и долготы представлены в виде двух отдельных полей.
GARS, GEOREF, UTM, USNG и MGRS являются форматами координат из одной строки, что означает, что только одно поле содержит координату.
Дополнительные сведения см. в описании параметра Формат входных координат (Input Coordinate Format).
Все несистемные поля из входной таблицы, в том числе входные поля, перемещаются в выходной класс точечных объектов.
Имена выходных полей сопоставляются с именем обозначения выходных координат. Например, если в качестве формата выходных данных используется MGRS, выходному полю присваивается новое имя MGRS.
Если в выходных данных уже существует поле с тем же именем, что и входное поле, имя скопированного поля добавляется с уникальным номером.
Инструмент Добавить поля X, Y (Add XY Coordinates) используется для добавления двух полей (POINT_X и POINT_Y) в выходную таблицу класса точечных объектов. Эти поля содержат координаты точки в единице системы координат класса пространственных объектов.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_table |
Таблица, содержащая поля с обозначениями координат, подлежащими конвертации. | Table View |
out_featureclass |
Выходной класс пространственных объектов точек. Таблица атрибутов будет содержать все поля входной таблицы вместе с полями, содержащими конвертированные значения в выходном формате. | Feature Class |
x_field |
Поле из входной таблицы, содержащей значение долготы. В форматах DD_2, DDM_2 и DMS_2 эту функцию выполняет поле долготы. Для DD_1, DDM_1, DMS_1, GARS, GEOREF, UTM, USNG и MGRS используется поле, в котором содержатся значения как широты, так и долготы. | Field |
y_field |
Поле из входной таблицы, содержащей значение широты. Для DD_2, DDM_2 и DMS_2 используется поле широты. Этот параметр игнорируется для DD_1, DDM_1, DMS_1, GARS, GEOREF, UTM, USNG и MGRS. | Field |
input_coordinate_format |
Формат координат входных полей. По умолчанию используется DD_2.
DD, DDM и DMS также представляют собой допустимый ключевые слова, которые можно использовать путем простого ввода (в диалоговом окне) или передачи значения в скрипте. Тем не менее, ключевые слова, содержащие нижнее подчеркивание и число, сообщают, поступают ли значения из одного или из двух полей. | String |
output_coordinate_format |
Формат координат, в который будут конвертироваться входные обозначения. По умолчанию используется DD_2.
DD, DDM и DMS также представляют собой допустимый ключевые слова, которые можно использовать путем простого ввода (в диалоговом окне) или передачи значения в скрипте. Тем не менее, ключевые слова, содержащие нижнее подчеркивание и число, сообщают, поступают ли значения из одного или из двух полей. | String |
id_field (дополнительно) |
Любое поле из входной таблицы. Выбранное поле будет скопировано в выходную таблицу. Если значения в этом поле уникальны, это можно использовать для добавления выходных записей обратно во входную таблицу. | Field |
spatial_reference (дополнительно) |
Пространственная привязка выходного набора классов точечных объектов. По умолчанию используется GCS_WGS_1984. Если выходные данные используют систему координат, отличную от той, которая используется входными данными, инструмент проецирует данные. Если входные и выходные данные находятся в различных датумах, преобразование рассчитывается на основе систем координат входных и выходных данных, а также экстента данных. | Spatial Reference |
Пример кода
Основное использование инструмента "Конвертировать обозначения координат" (Convert Coordinate Notation) с одним входным полем.
#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")
Основное использование инструмента "Конвертировать обозначения координат" (Convert Coordinate Notation) с двумя входными полями.
# 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])