Преобразование координат с помощью pyproj
Введение
pyproj — библиотека Python с открытым кодом для перевода координат из одной системы координат (CRS) в другую. Она опирается на PROJ — стандартную библиотеку преобразования координат на языке C; ту же PROJ используют QGIS, GDAL и PostGIS.
pyproj работает и внутри to_crs в GeoPandas, и при перепроецировании в Rasterio. Прямое использование позволяет за несколько строк кода перевести точки GPS, координаты из таблицы или ответ API в метрическую систему. Понятия CRS, датума и проекции раскрыты в статье о системе координат и перепроецировании; здесь показано, как они применяются в коде. Все примеры ниже запущены в pyproj 3.7.2 (PROJ 9.5.1).
Объект CRS и код EPSG
В pyproj система задаётся объектом CRS. Его можно создать из кода EPSG, текста WKT или строки PROJ, но код EPSG — самый точный и короткий путь:
from pyproj import CRS
wgs84 = CRS.from_epsg(4326)
utm42 = CRS.from_epsg(32642)
print(wgs84.name) # WGS 84
print([o.abbrev for o in wgs84.axis_info]) # ['Lat', 'Lon']
print(utm42.name) # WGS 84 / UTM zone 42N
print(utm42.axis_info[0].unit_name) # metre
axis_info раскрывает важную деталь: в реестре EPSG для EPSG:4326 первая ось — широта, вторая — долгота. В системе UTM оси направлены на восток (X) и на север (Y), единица — метр.
Transformer и порядок осей
Преобразование выполняет объект Transformer. Он создаётся один раз и затем используется для любого числа точек. Здесь скрыта самая частая ошибка — порядок осей (axis order):
from pyproj import Transformer
xato = Transformer.from_crs("EPSG:4326", "EPSG:32642")
print([round(v) for v in xato.transform(69.28, 41.31)])
# [-560905, 7931326]
t = Transformer.from_crs("EPSG:4326", "EPSG:32642", always_xy=True)
x, y = t.transform(69.28, 41.31) # Ташкент, приблизительно
print(round(x, 2), round(y, 2)) # 523437.76 4573208.74
Первый трансформер следовал порядку из реестра: принял 69.28 за широту, 41.31 за долготу и вычислил точку за Северным полярным кругом. Сообщения об ошибке нет — результат просто оказывается не в том месте. Параметр always_xy=True всегда задаёт порядок «сначала долгота (X), затем широта (Y)»; это совпадает с привычным порядком в GeoJSON, Shapely и большинстве ГИС-программ.

Преобразование точки и списка
transform принимает вместо одного числа список или массив NumPy. Перевести тысячу точек одним вызовом без цикла заметно быстрее:
# Ташкент, Самарканд, Наманган (приблизительные центры)
lon = [69.28, 66.96, 71.67]
lat = [41.31, 39.65, 41.00]
xs, ys = t.transform(lon, lat)
print([round(v) for v in xs]) # [523438, 324973, 724563]
print([round(v) for v in ys]) # [4573209, 4390901, 4542191]
orqaga = Transformer.from_crs("EPSG:32642", "EPSG:4326", always_xy=True)
print(orqaga.transform(x, y)) # (69.28, 41.31)
Возврат исходного значения после обратного преобразования — простой способ проверить код. Значение X для Ташкента близко к 500 000 м, потому что он расположен рядом с центральным меридианом 42-й зоны (69° в. д.); этому меридиану в UTM присваивается ровно 500 000 м.
Зона UTM для Узбекистана
Система UTM делит Землю на 60 зон по 6 градусов. Узбекистан протянулся с запада на восток примерно от 56° до 73°, поэтому попадает в четыре зоны: 40N (EPSG:32640), 41N (EPSG:32641), 42N (EPSG:32642) и 43N (EPSG:32643). Основная часть территории — в 41N и 42N. Вместо ручного расчёта зону можно запросить из базы EPSG в pyproj:
from pyproj.aoi import AreaOfInterest
from pyproj.database import query_utm_crs_info
def utm_zona(lon, lat):
natija = query_utm_crs_info(
datum_name="WGS 84",
area_of_interest=AreaOfInterest(lon, lat, lon, lat))
return natija[0].code
print(utm_zona(69.28, 41.31)) # 32642 — Ташкент
print(utm_zona(64.42, 39.77)) # 32641 — Бухара
print(utm_zona(59.60, 42.46)) # 32640 — Нукус
Чем дальше точка от своей зоны, тем больше искажение расстояний. Для одной области достаточно её зоны; для расчёта площадей по всей республике выбирается равновеликая проекция.

Расстояние: градусы и метры
Считать расстояние прямо по координатам в градусах бессмысленно: на широте Ташкента 1 градус долготы — примерно 83,7 км, а 1 градус широты — примерно 111 км. Сравним расстояние между Ташкентом и Самаркандом тремя способами:
import math
from pyproj import Geod
lon = [69.28, 66.96] # Ташкент, Самарканд
lat = [41.31, 39.65]
print(round(math.hypot(lon[1] - lon[0], lat[1] - lat[0]), 2)) # 2.85 "градуса"
x, y = t.transform(lon, lat)
print(round(math.hypot(x[1] - x[0], y[1] - y[0]))) # 269489 m
geod = Geod(ellps="WGS84")
_, _, d = geod.inv(lon[0], lat[0], lon[1], lat[1])
print(round(d)) # 269567 m
У первого результата нет единицы измерения. Разница между плоским расстоянием в UTM и геодезическим расстоянием (geodesic distance) по эллипсоиду — 78 м, то есть 0,03 %. Она появилась потому, что Самарканд далеко от центрального меридиана 42-й зоны. Для длинных расстояний или маршрутов, пересекающих несколько зон, Geod надёжнее.

Преобразование датума и точность
Если исходная и целевая CRS опираются на разные датумы, например Пулково 1942 (EPSG:4284) на старых картах и WGS 84, PROJ находит несколько вариантов преобразования датума (datum transformation). У каждого своя точность и область применения:
from pyproj.transformer import TransformerGroup
aoi = AreaOfInterest(69.28, 41.31, 69.28, 41.31)
tg = TransformerGroup("EPSG:4284", "EPSG:4326", always_xy=True,
area_of_interest=aoi)
for tr in tg.transformers:
print(tr.accuracy, tr.area_of_use.name[:28])
# 3.0 Russian Federation - onshore
# 4.5 Armenia; Azerbaijan; Belarus
# 44.0 Kazakhstan - onshore includi
# 999.0 Russian Federation - onshore
lon2, lat2 = tg.transformers[1].transform(69.28, 41.31)
print(round(lon2, 6), round(lat2, 6)) # 69.27925 41.31019
В Ташкенте сдвиг между двумя датумами — около 66 м. Вариант с точностью 3 м в начале списка задан только для России: область выбирается по ограничивающему прямоугольнику, поэтому он формально «охватил» и Ташкент. Вариант, официально охватывающий Узбекистан, — второй, с точностью 4,5 м; разница между двумя результатами около 3 м. Поэтому в точной работе не стоит полагаться на вариант, автоматически выбранный Transformer.from_crs: проверяются area_of_use и accuracy, а выбранный метод записывается в метаданные.
Заключение
Надёжное преобразование в pyproj опирается на три правила: CRS задаётся точно кодом EPSG, Transformer всегда создаётся с always_xy=True, а результат проверяется обратным преобразованием или известной контрольной точкой.
Расстояния и площади считаются в метрической системе, подходящей для территории, или по эллипсоиду через Geod. Если датумы различаются, вариант преобразования не оставляют на волю случая — его область применения и точность сверяют с требованиями проекта.

