ПараметрЗначение
ИмяCOORDINATE-EARTH (документ спецификации BIND COORDINATE-EARTH)
TAG ID0x064L
Codec ID0x00000640
Документ спецификации0x00000000/codecs/0x00000640/ (цель DECLARE 0640)
Раздел3 0011 (Value), смещение внутри раздела C = 4
KindValue · семейство: NUMERIC
TAG WORD0000 0110 0100 LLLL (000K KKKC CCCC LLLL)
Описание индексаширота и долгота на Земле (WGS 84) в binary64, неопределённость в binary32 и Reference на её единицу (ABSENT = неизвестно)
На стороне Hugovalue/numeric/coordinate-earth.md

Поля (документ спецификации)

Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1latitude#2простое значение, 4 WORD0630 BINARY-FLOAT
2longitude#3простое значение, 4 WORD0630 BINARY-FLOAT
3uncertainty#4простое значение, 2 WORD0630 BINARY-FLOAT
4unit#12запись000F весь раздел 0 (шаблон, Reference), 020F весь раздел 1 (шаблон, Reference), 040F весь раздел 2 (шаблон, Reference), 0000 ABSENT (необязательное поле)

COORDINATE-EARTH — координатный Value, задающий точку на Земле широтой, долготой и неопределённостью. Прямой код Value 0x064L, семейство NUMERIC. По смыслу он совпадает с geo:широта,долгота;u=неопределённость из RFC 5870 (geo URI; система координат WGS 84), но хранится не строкой, а числами фиксированной ширины. Неопределённость записывается вместе с единицей. Координаты небесных тел вне Земли записываются через COORDINATE-GEO (0x065L).

Раскладка

TAG WORD          0000 0110 0100 LLLL      Codec 0x064L
Latitude          4 WORD, простое значение, IEEE 754 binary64 (градусы)
Longitude         4 WORD, простое значение, IEEE 754 binary64 (градусы)
Uncertainty       2 WORD, простое значение, IEEE 754 binary32 (в единицах Unit)
Unit              одна запись Reference или маркер места 0x0000 ABSENT

Интерпретация и действительность

  • Payload — это Latitude 4 WORD, Longitude 4 WORD, Uncertainty 2 WORD и затем ровно одна запись Unit. Курсор после чтения Unit должен совпасть с концом записи.
  • Система координат — WGS 84 (по умолчанию crs=wgs84 в RFC 5870).
  • Latitude и Longitude — IEEE 754 binary64, склеенные из WORD Payload в порядке big-endian (то же битовое расположение, что у binary64 в BINARY-FLOAT). Единица — градус (°).
    • Значение должно быть конечным. NaN и ±Infinity — invalid.
    • Latitude: -90 ≤ φ ≤ 90 (север положителен), Longitude: -180 ≤ λ ≤ 180 (восток положителен).
    • Порядок осей — широта, долгота (как в RFC 5870 и ISO 6709). Это не порядок x (долгота), y (широта) из WKB и GeoJSON.
  • Uncertainty — IEEE 754 binary32 из 2 WORD, склеенных в порядке big-endian (то же битовое расположение, что у binary32 в BINARY-FLOAT). Означает, что истинное положение лежит внутри этого радиуса; значение читается в единицах Unit.
    • Должно быть конечным и не меньше +0. Отрицательные значения, -0 (8000 0000), NaN и ±Infinity — invalid.
    • 0 (при наличии Unit): точная координата. В какой бы единице она ни была записана, смысл тот же.
  • Unit — это Reference, указывающий на единицу Uncertainty. Value не принимается. Quantifier — Identified.
    • Рекомендуется использовать элементы-единицы Викиданных WIKIDATA-QID: градус Q28390, угловая минута Q209426, угловая секунда Q829073, метр Q11573, миллиметр Q174789 и т. д. Единицу без QID указывают другим Reference (LOCAL, GEUL и др.). Если на одну и ту же единицу указывает несколько Reference, канонической является форма с QID.
    • Если Unit — метр (Q11573), Uncertainty совпадает с u из RFC 5870.
  • Неизвестно: на месте Unit пишется ABSENT (0x0000), а Uncertainty равно +0 (0000 0000). Это то же, что пропуск u в RFC 5870. Если Unit равен ABSENT, а Uncertainty не равно +0, это invalid (представление фиксируется единственным).
  • Высота не хранится. При необходимости она определяется отдельным форматом. Высота (altitude) в Викиданных в выборке не встречалась (0/23 066); если значение есть, оно не преобразуется, а исходный текст сохраняется как UTF8-TEXT.
  • Для земных координат рекомендуется этот формат. Координата, записанная в COORDINATE-GEO с Землёй (Q2), не invalid, и сравнивающая сторона приводит её к той же координате.
  • Документ спецификации geul.org 0x00000000/codecs/0x00000640 задаёт для полей простых значений Latitude·Longitude·Uncertainty CODEC BINARY-FLOAT (0630) (4 WORD = binary64, 2 WORD = binary32), а для поля записи Unit — CODEC 000F·020F·040F (любой Reference) и 0000 (ABSENT).

Длина

  • Общая длина — TAG 1 WORD + 10 WORD + запись Unit.
UnitВсегоTAG
ABSENT (1 WORD)12 WORD064B (LLLL=1011)
QID умещается в 1 WORD (2 WORD, например градус Q28390)13 WORD064C (LLLL=1100)
QID занимает 2 WORD (3 WORD, например угловая минута Q209426)14 WORD064D (LLLL=1101)
Запись Unit от 4 WORDот 15 WORDрасширенная длина (Запись и TAG WORD)
  • Парных чётно-нечётных Codec не вводится.

Соответствие Викиданным

globecoordinate в Викиданных: {"latitude":52.516666666667,"longitude":13.383333333333,"altitude":null,"precision":0.016666666666667,"globe":"http://www.wikidata.org/entity/Q2"}

ВикиданныеCOORDINATE-EARTH
globe …/entity/Q2этот формат (Земля). Другие небесные тела — COORDINATE-GEO
latitude, longitudebinary64 как есть (значения Викиданных изначально binary64, потерь нет)
precision (градусы)Uncertainty и Unit. См. ниже «Точность»
precision null или отсутствуетUnit = ABSENT, Uncertainty = +0 (неизвестно)
altitudeотбрасывается (всегда null)
  • precision в Викиданных — не погрешность измерения, а разрешение записи (в каких градусах, минутах, секундах записана координата). Uncertainty в GEUL переносит это значение без изменения. Это не радиус с добавлением ошибок измерения и системы координат.

Точность

precision переносится без пересчёта. Выбирается первая из единиц (градус, угловая минута, угловая секунда), которая восстанавливает исходную запись.

Исходный precision (пример)UnitUncertainty
0.0001, 0.0000010, 1, 10 (10^k градусов)градус Q28390binary32 этого значения
короткая десятичная запись вроде 0.0166667градус Q28390binary32 этого значения
0.016666666666667 (1/60°)угловая минута Q2094261
0.00027777777777778 (1/3600°)угловая секунда Q8290731
0.000027777777777778 (1/36000° = 0.1″)угловая секунда Q8290730.1
  • Прямое преобразование: в порядке градус, угловая минута (×60), угловая секунда (×3600) в качестве Uncertainty берётся ближайшее binary32 к произведению precision на число единиц, и используется первая единица, для которой обратное преобразование ниже возвращает исходную запись precision.
  • Обратное преобразование: кратчайшая десятичная запись Uncertainty (самое короткое число, которое читается обратно в то же binary32) делится на число единиц и переводится в градусы, затем записывается так, как Викибаза пишет в дамп (14 значащих цифр, меньше 1e-4 — в экспоненциальной записи 1.0e-6·2.7777777777778e-5). База данных загрузки (jsonb) хранит это в десятичной записи 0.0000010·0.000027777777777778.
  • Если ни одна единица не восстанавливает исходную запись (запись с 17 значащими цифрами 0.0002777777777777778, выбросы, похожие на вычисленные значения и т. п.), координата целиком не преобразуется, а исходный текст сохраняется как UTF8-TEXT. То же относится к отрицательному precision и к значениям с пустым небесным телом.
  • Выборка Викиданных Q1–Q10000 (7 026 утверждений о координатах, с precision 6 824): исходная запись восстановлена в 5 933 случаях (86,9%; градус 4 104, угловая секунда 1 370, угловая минута 459). Из 891 невосстановленного случая 753 относятся к серии 1/3600 и 1/60 в записи с 17 значащими цифрами.

Пример

Берлин 52.516666666667, 13.383333333333, precision 1/60° (угловая минута 1):

064D 404A 4222 2222 2251 402A C444 4444 4389 3F80 0000 0142 0003 3212
  • TAG 064D (14 WORD), Latitude 404A 4222 2222 2251, Longitude 402A C444 4444 4389, Uncertainty 3F80 0000 (binary32 1.0), Unit 0142 0003 3212 (WIKIDATA-QID Q209426, угловая минута).
  • Текстовая запись: COORDINATE-EARTH(52.516666666667, 13.383333333333, 1, Q209426).

Та же точка с неизвестной неопределённостью: 064B 404A 4222 2222 2251 402A C444 4444 4389 0000 0000 0000 (12 WORD, Unit ABSENT).

Стандартное обоснование

  • Смысл: RFC 5870, A Uniform Resource Identifier for Geographic Locations (‘geo’ URI) — порядок широта, долгота; неопределённость u (метры); система координат по умолчанию WGS 84. Если Unit — метр, Uncertainty = u.
  • Числа: IEEE 754 binary64 (широта и долгота), binary32 (неопределённость).
  • Порядок осей и диапазон: ISO 6709 (Standard representation of geographic point location by coordinates).
  • Единицы: элементы-единицы Викиданных (QID). Расположение фиксированной ширины, поле Unit и представление неизвестного — правила GEUL.

Открытые проблемы

  1. Высота.
  2. Формат для хранения исходной строки ISO 6709 (COORDINATE-ISO6709) определится, когда появится применение.
  3. Способ перенести без потерь записи precision Викиданных с 17 значащими цифрами (около 11% выборки).

Связанные страницы

  • Value, COORDINATE-GEO, BINARY-FLOAT, маркер места
  • Формат Issuer POINT2-BINARY64 — это обычная двумерная точка, оставляющая систему координат, единицы и смысл осей внешнему контексту, а данный формат — географическая координата на Земле.

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x00000640/latest.geul, прочитанный командой geul show (16-ричные цифры в верхнем регистре).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000064000000000
BODY
#1 DECLARE 0x0640
#2 FIELD #1 0x0004
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "COORDINATE-EARTH"
#6 BIND #2 "latitude"
#7 BIND #3 "longitude"
#8 BIND #4 "uncertainty"
#9 CODEC #2 0x0630
#10 CODEC #3 0x0630
#11 CODEC #4 0x0630
#12 FIELD #1 record
#13 BIND #12 "unit"
#14 CODEC #12 0x000F
#16 CODEC #12 0x020F
#17 CODEC #12 0x040F
#15 CODEC #12 0x0000