항목값
이름COORDINATE-EARTH (규격 문서 BIND COORDINATE-EARTH)
TAG ID0x064L
코덱 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 = 미상)
Hugo 쪽value/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이다. 뜻은 RFC 5870(geo URI)의 geo:위도,경도;u=불확도(좌표계 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 레코드 1개, 또는 자리 표지 0x0000 ABSENT

해석과 유효성

  • Payload는 Latitude 4 WORD, Longitude 4 WORD, Uncertainty 2 WORD 뒤에 Unit 레코드 정확히 하나다. Unit을 읽은 커서는 레코드 끝과 맞아야 한다.
  • 좌표계는 WGS 84다(RFC 5870의 기본 crs=wgs84).
  • Latitude·Longitude는 Payload WORD를 big-endian 순서로 이어 붙인 IEEE 754 binary64다(BINARY-FLOAT의 binary64와 같은 비트 배치). 단위는 도(°)다.
    • 유한한 값이어야 한다. NaN과 ±Infinity는 invalid다.
    • Latitude는 -90 ≤ φ ≤ 90(북쪽이 양수), Longitude는 -180 ≤ λ ≤ 180(동쪽이 양수)이다.
    • 축 순서는 위도, 경도다(RFC 5870·ISO 6709와 같다). WKB·GeoJSON의 x(경도)·y(위도) 순서가 아니다.
  • Uncertainty는 2 WORD를 big-endian으로 이어 붙인 IEEE 754 binary32다(BINARY-FLOAT의 binary32와 같은 비트 배치). 실제 위치가 이 반경 안에 있다는 뜻이고, 값은 Unit 단위로 읽는다.
    • 유한한 +0 이상이어야 한다. 음수, -0(8000 0000), NaN, ±Infinity는 invalid다.
    • 0(Unit이 있을 때): 정확한 좌표. 어느 단위로 적어도 같다.
  • Unit은 Uncertainty의 단위를 가리키는 Reference다. Value는 받지 않는다. Quantifier는 Identified다.
    • 위키데이터 단위 항목 WIKIDATA-QID를 쓰기를 권한다: 도 Q28390, 각분 Q209426, 각초 Q829073, 미터 Q11573, 밀리미터 Q174789 등. QID가 없는 단위는 다른 Reference(LOCAL, GEUL 등)로 가리킨다. 같은 단위를 가리키는 Reference가 여럿이면 QID가 정규형이다.
    • Unit이 미터(Q11573)이면 Uncertainty는 RFC 5870의 u와 같다.
  • 미상: Unit 자리에 ABSENT(0x0000)를 쓰고 Uncertainty는 +0(0000 0000)으로 둔다. RFC 5870에서 u를 생략한 경우와 같다. 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은 측정 오차가 아니라 기록 해상도다(좌표를 몇 도·분·초 단위로 적었는가). GEUL Uncertainty는 그 값을 바꾸지 않고 옮긴다. 측정·좌표계 오차를 더한 반경은 아니다.

정밀도

precision을 환산 없이 옮긴다. 도·각분·각초 중 원래 표기를 되살리는 첫 단위를 고른다.

precision 원문(예)UnitUncertainty
0.0001, 0.0000010, 1, 10 (10^k 도)도 Q28390그 값의 binary32
0.0166667 같은 짧은 10진 표기도 Q28390그 값의 binary32
0.016666666666667 (1/60°)각분 Q2094261
0.00027777777777778 (1/3600°)각초 Q8290731
0.000027777777777778 (1/36000° = 0.1″)각초 Q8290730.1
  • 정변환: 도, 각분(×60), 각초(×3600) 순서로, precision에 단위 수를 곱한 값에 가장 가까운 binary32를 Uncertainty로 삼고, 아래 역변환이 precision 원문을 그대로 되돌리는 첫 단위를 쓴다.
  • 역변환: Uncertainty의 가장 짧은 10진 표기(그 binary32로 다시 읽히는 가장 짧은 수)를 단위 수로 나눠 도로 바꾸고, 위키베이스가 덤프에 적는 방식(유효숫자 14자리, 1e-4 미만은 지수 표기 1.0e-6·2.7777777777778e-5)으로 적는다. 적재 DB(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건이 유효숫자 17자리 표기의 1/3600·1/60 계열이다.

예시

베를린 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%)를 무손실로 옮길 방법.

관련 페이지

규격 문서 원문

규격 문서 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