Иногда прилетает фотография без геометки. Не «найди, где это», а «это вообще где, примерно». Дальше начинается обычный разговор: смотри на вывески, смотри на язык, смотри на номера машин. Всё это работает, пока на снимке есть вывеска. А если её нет — голая стена, асфальт, тень от фонаря — то остаётся ровно одно, что на снимке объективно измерено: угол Солнца и длина тени.
Вот про это и тема. Пять шагов, из которых два считаются кодом, один — часами, два — руками. Ничего экзотического: EXIF, формулы NOAA, сферическая тригонометрия из школьного курса в правильном порядке, и трезвая оценка того, сколько стоит каждая ошибка.
EXIF: без exiftool, потому что он тут не нужен
Первое, что делает человек — тянется за exiftool. Мне он был не нужен по одной причине: мне нужен разбор, где я понимаю каждое смещение. Свой парсер JPEG — это сто строк и один вечер, и зато потом можно ответить на вопрос «а точно ли там ничего нет», а не «exiftool ничего не показал».
Формат простой до обидного. Идём по маркерам: FFD8, потом сегменты, у каждого маркер и двухбайтовая длина. Нас интересует APP1 с подписью Exif\0\0 — за ней TIFF-заголовок с порядком байт (II или MM), смещением на IFD0, а оттуда указатели на ExifIFD и GPS IFD. Двенадцать типов значений, из которых реально встречаются семь. Всё.
ORDER = {b"II": "<", b"MM": ">"}
def read_exif(data: bytes) -> dict:
for marker, payload in iter_segments(data):
if marker != 0xE1 or not payload.startswith(b"Exif\0\0"):
continue
tiff = payload[6:]
order = ORDER.get(tiff[:2])
if order is None:
return {}
magic, ifd0_off = struct.unpack_from(order + "HI", tiff, 2)
if magic != 42:
return {} # не TIFF — не наш случай
return walk_ifds(tiff, order, ifd0_off)Ошибка, на которой спотыкается каждый второй самописный парсер: длина у сегмента включает сами два байта длины, но не включает маркер. Смещение считается от начала файла, а внутри APP1 — от начала TIFF-заголовка. Перепутать эти три системы координат — и парсер читает мусор, но не падает, а просто возвращает бессмысленные значения. Поэтому в тестах есть проверка на значение, чей указатель вылез за границу блока: парсер обязан вернуть None, а не угадать.
Второй тест, который я считаю обязательным — MM и II на одном и том же наборе данных. У Pillow порядок байт при записи зависит от версии и платформы, так что «мой файл читается» ничего не доказывает. В наборе есть вручную собранный TIFF в обоих порядках, с GPS-блоком на указателе, и южное полушарие обязано стать отрицательной широтой, западная долгота — отрицательной долготой. Это ловит самую частую содержательную ошибку: S и W теряются, и точка уезжает в другой конец карты.
Солнце: формула NOAA, семь шагов
Дальше нужна позиция Солнца на конкретный момент UTC и конкретную точку. Тут я не изобретал ничего: NOAA Solar Calculator, семь шагов — юлианский день, столетия от J2000, средняя долгота и средняя аномалия, эклиптическая долгота, склонение δ, уравнение времени, часовой угол H. Потом высота и азимут. Рефракция включена, но параметром: у горизонта она даёт до 0.5°, и в тестах тождеств я её выключаю, иначе проверяю не геометрию, а модель атмосферы.
Проверка на этом шаге одна и жёсткая. Восход, закат и солнечный полдень для трёх городов сверены с sunrise-sunset.org (запросы 10.11.2026, значения вместе с URL вбиты в тест). Худшее расхождение — 29 секунд на восходе в Нью-Йорке. Москва 21 июня: +2 и −2 секунды. Берлин: −15 и −29. Допуск в тесте 90 секунд, и это не поблажка: разница между моделями (порог −0.833°, параллакс, шаг поиска) физически больше, чем ошибка самих формул. Если бы я поставил допуск «секунда», тест падал бы навсегда и его бы отключили — а отключённый тест хуже отсутствующего.
Обратная задача: из тени в координату
Вот здесь начинается то, ради чего всё. Дано: направление тени в кадре, отношение длины тени к высоте объекта и время UTC. Неизвестны широта φ и часовой угол H. Два уравнения связывают их с известными высотой h, азимутом A и склонением δ. Исключаем cos δ cos H — и остаётся одно уравнение относительно широты:
sin h · sin φ + cos A · cos h · cos φ = sin δЭто R·sin(φ + ψ) = sin δ. Два корня, всегда два: синус симметричен. Дальше H = atan2(sin H, cos H), и долгота считается как λ = H + 180° − 15°·(час UTC) − EoT/4.
a = math.sin(sun_elevation * DEG)
b = math.cos(sun_azimuth * DEG) * math.cos(sun_elevation * DEG)
c = math.sin(declination * DEG)
for i, phi in enumerate(_solve_sinusoid(a, b, c)):
if abs(phi) > 90.0:
# второй корень часто уходит за полюс — печатаем с причиной,
# чтобы было видно: проверка была, а не «сошлось»
continue
sin_ha = -math.sin(sun_azimuth * DEG) * math.cos(sun_elevation * DEG) / cos_dec
cos_ha = (math.sin(sun_elevation * DEG)
- math.sin(declination * DEG) * math.sin(phi * DEG)) / (cos_dec * cos_phi)
ha = math.atan2(sin_ha, cos_ha) * RAD
h_back, az_back = _forward(phi, ha, declination) # обратный счёт
if abs(h_back - sun_elevation) >= TOL_ELEV:
reason = "высота не сходится"Второй корень печатается всегда, с причиной отбраковки. Не потому что он всегда мусор — а потому что иногда он настоящий, и об этом ниже. Обратный пересчёт после решения тоже обязателен: если из найденной точки Солнце не встаёт туда, откуда пришло, решение неверное, каким бы красивым ни было число.
Круг «точка → тень → точка» на четырёх городах: Берлин на высоте Солнца 20° даёт ошибку широты −0.0442° и долготы −0.0021°. Сидней +0.0116° и +0.0045°. Мехико −0.0121° и +0.0014°. Это ошибки округления входных данных, а не модели: я кормлю решатель углами, посчитанными с точностью до третьего знака.
Где это ломается, и почему я оставил это в выводе
Рейкьявик, 21 декабря, Солнце на 2.5° над горизонтом. Оба корня действительны: −68.98° широты (это Антарктида) и +63.88° (настоящая точка). Разница между ними — 132.9° широты. То есть по одной короткой тени на низком Солнце я не знаю, в каком полушарии снято, и никакая математика это не разрешит — информации в кадре физически не хватает. Разрешается это рельефом, растительностью, языком вывесок, чем угодно ещё. И ошибка широты у настоящей ветки там −0.268° вместо −0.044° — низкое Солнце стоит дорого, потому что малая ошибка в высоте превращается в большой разброс по широте.
Я специально держу этот случай в transcript.txt. Соблазн написать «алгоритм восстанавливает координату» велик, и он был бы ложью: алгоритм восстанавливает две координаты, и выбрать из них надо не математикой.
Цена каждой ошибки — это самое полезное, что тут есть
Часы врут на 10 минут → долгота уезжает на 2.49975°, это 169 км по параллели. Широта при этом едет на 0.00196°, то есть никуда. Часы врут на час → 14.99847° долготы, 1015 км, и снова широта почти на месте (−0.01174°).
Азимут тени врёт на 0.5° → широта −0.0411°, долгота +0.4917°. На 1° → −0.0849° и +0.9834°. На 3° → −0.2875° и +2.9498°.
Вывод, который стоит записать на бумажке: тень держит широту, часы держат долготу. Они независимы, и это очень удобно. Если EXIF сохранил DateTimeOriginal и OffsetTimeOriginal — у тебя есть долгота с точностью до пары градусов и широта с точностью до сотых. Если часовой пояс потерян (а OffsetTime теряется чаще всего — его нет в старых камерах и его вырезают мессенджеры) — широта остаётся, долгота превращается в мусор.
И отсюда практическое: тень надо мерить по длинному объекту. Фонарный столб, угол дома, забор. Бордюр даёт ошибку в полтора-два градуса просто потому, что его край в кадре не прямая.
EXIF после мессенджера, и что это доказывает
Отдельная команда вырезает APP1 целиком и пересчитывает длины сегментов — не «пересохраняет через Pillow», а именно вырезает блок и правит поле длины, потому что контейнер после такой операции должен остаться валидным по стандарту. Файл 5878 → 5428 байт, минус 450 байт метаданных, тегов 11 → 0, координат нет, и при этом JPEG открывается, а пиксели совпадают побайтно.
Зачем это в теме про геолокацию. Ровно затем, что половина людей уверена: «я отправил через телегу, всё вырезалось». Иногда да, иногда нет — зависит от того, картинкой отправили или файлом, и от того, что делал клиент. Проверять надо, а не верить. Двадцать секунд и один запуск.
Обратная сторона того же: если ты нашёл снимок с координатами, не рассказывай про «магию OSINT». Это тег, который не вырезали.
Что проверено
109 тестов, все зелёные. test_sun.py — 37: внешняя эфемерида, тождества, физика. test_shadow.py — 29: круг «точка → тень → точка», двусмысленность, чувствительность. test_exif.py — 20: разбор JPEG/TIFF/IFD, оба порядка байт, битые файлы. test_strip.py — 12: удаление EXIF, целостность контейнера и пикселей. test_cli.py — 11: команды и коды возврата.
Тождество полудня равноденствия h = 90 − |φ − δ| сходится с посчитанной высотой до 4·10⁻¹² градуса. Приближение 90 − |φ| промахивается ровно на склонение дня — −0.0413° для 20.03.2026, и это видно в каждой строке таблицы в транскрипте, а не спрятано в среднее. Азимут геометрического восхода в равноденствие — 90.14…90.25°, и остаток объясняется тем же δ. Симметрия утро/вечер при фиксированном δ даёт сумму азимутов 360° с точностью 10⁻⁹.
Всё, что выше, лежит в transcript.txt в архиве: вывод целиком, без правок.
Что не проверено, и это важнее списка выше
Настоящих фотографий в проекте нет. Все JPEG сгенерированы — часть Pillow, часть руками собранным TIFF. Геометрия и парсер от этого не зависят, но у реальной камеры бывают свои порядки тегов, битые MakerNote и OffsetTime в неожиданном IFD. Первое, что сломается на живом файле, — именно MakerNote, и я честно не знаю, в каком месте.
Обратный поиск по картинке не автоматизирован вообще. Yandex, Google Lens, Bing, TinEye отдают результат только через браузер, с капчей и лимитами; в коде этого нет, есть только шаг, куда вставлять ссылки руками. Спутниковый шаг тоже ручной: координата из тени даёт полосу широт, дальше человек сверяет кварталы. Кода для скачивания снимков нет.
Модель плоская в одном конкретном смысле: сферическая астрономия без параллакса и без рельефа. Горизонт предполагается открытым. Дом, склон холма или стена ломают и высоту, и азимут — а код об этом не знает и не узнает.
И ещё одно, о чём обычно молчат: я не проверял, насколько хорошо OffsetTimeOriginal пишут реальные камеры. Мой тестовый файл пишет Pillow, и он пишет правильно по определению. Насколько это соответствует тому, что делает Sony или Canon — вопрос без ответа в этом проекте.
Запуск
python -m geo info photo.jpg
python -m geo sun --utc 2026-11-10T11:20 --lat 52.52 --lon 13.405
python -m geo shadow --az 7.5607 --elev 20.0119 --utc 2026-11-10T11:20 --lat 52.52 --lon 13.405
python -m geo strip photo.jpg clean.jpg
python -m pytest -q # 109 passed
python make_transcript.py # пересобрать transcript.txtИз зависимостей только Pillow, и только для тестов и генерации картинок. Солнце, тень и EXIF — чистая стандартная библиотека. Ставится на любой питон 3.10+.
Структура
geo/sun.py NOAA: julian_day, solar_elements, solar_position, sun_times, solar_noon
geo/shadow.py обратная задача, азимут → регион, чувствительность к часам и глазомеру
geo/exif.py iter_segments, TiffReader, read_exif, report, strip_exif
geo/strip.py «файл → файл» с отчётом, что вырезано
geo/cli.py info / sun / shadow / strip
tests/ 109 тестов
conftest.py сборщик TIFF и JPEG для тестов
transcript.txt полный вывод прогонаВ архиве всё перечисленное плюс README, где отдельно расписано, как считается тень, и отдельно — почему у низкого Солнца допуски шире. Начни с geo/shadow.py: там сорок строк, которые превращают угол в координату, и там же видно, где кончается математика и начинается «нужно ещё что-то».