| البند | القيمة |
|---|---|
| الاسم | COORDINATE-EARTH (مستند المواصفة BIND COORDINATE-EARTH) |
| TAG ID | 0x064L |
| Codec ID | 0x00000640 |
| مستند المواصفة | 0x00000000/codecs/0x00000640/ (هدف DECLARE هو 0640) |
| القسم | 3 0011 (Value)، الإزاحة داخل القسم C = 4 |
| Kind | Value · العائلة: NUMERIC |
| TAG WORD | 0000 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 |
|---|---|---|---|---|---|
| 1 | latitude | #2 | قيمة خام 4 WORD | 0630 BINARY-FLOAT | |
| 2 | longitude | #3 | قيمة خام 4 WORD | 0630 BINARY-FLOAT | |
| 3 | uncertainty | #4 | قيمة خام 2 WORD | 0630 BINARY-FLOAT | |
| 4 | unit | #12 | سجل | 000F القسم 0 كله (حرف بدل، Reference)، 020F القسم 1 كله (حرف بدل، Reference)، 040F القسم 2 كله (حرف بدل، Reference)، 0000 ABSENT (حقل اختياري) |
COORDINATE-EARTH قيمة Value إحداثية تمثل نقطة على الأرض بخط العرض وخط الطول وعدم اليقين. الرمز المباشر في Value هو 0x064L والعائلة NUMERIC. معناها مطابق لـ geo:خط العرض,خط الطول;u=عدم اليقين (نظام الإحداثيات WGS 84) في RFC 5870 (geo URI)، وتُحفظ بقيم عددية ثابتة العرض لا كسلسلة نصية. يُكتب عدم اليقين مع وحدته. أما إحداثيات الأجرام خارج الأرض فتُكتب بـ 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 تُوصَل فيه Payload WORD بترتيب 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 تُوصَل فيه 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.
- يُوصى باستخدام هذه الصيغة لإحداثيات الأرض. والإحداثية التي كُتب فيها الأرض (Q2) في COORDINATE-GEO ليست invalid أيضاً، وعلى الجهة المقارِنة أن تطابقها مع الإحداثية نفسها.
- يضع مستند المواصفة
0x00000000/codecs/0x00000640في geul.org على حقول القيم الخام 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 WORD | 064B (LLLL=1011) |
| عندما تتسع QID في 1 WORD (2 WORD، مثل الدرجة Q28390) | 13 WORD | 064C (LLLL=1100) |
| عندما تكون QID من 2 WORD (3 WORD، مثل الدقيقة القوسية Q209426) | 14 WORD | 064D (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, longitude | binary64 كما هي (قيمة ويكي بيانات في الأصل binary64 فلا فقد) |
| precision (بالدرجات) | Uncertainty وUnit. انظر “الدقة” أدناه |
| precision تساوي null أو غير موجودة | Unit = ABSENT، Uncertainty = +0 (مجهول) |
| altitude | تُهمل (دائماً null) |
- precision في ويكي بيانات ليست خطأ قياس بل دقة التسجيل (بكم درجة أو دقيقة أو ثانية كُتبت الإحداثية). تنقل GEUL Uncertainty هذه القيمة دون تغيير. وليست نصف قطر أُضيف إليه خطأ القياس أو خطأ نظام الإحداثيات.
الدقة
تُنقل precision دون تحويل. تُختار أول وحدة تعيد الصيغة الأصلية من بين الدرجة والدقيقة القوسية والثانية القوسية.
| precision الأصلية (مثال) | Unit | Uncertainty |
|---|---|---|
0.0001, 0.0000010, 1, 10 (10^k درجة) | الدرجة Q28390 | binary32 لتلك القيمة |
صيغة عشرية قصيرة مثل 0.0166667 | الدرجة Q28390 | binary32 لتلك القيمة |
0.016666666666667 (1/60°) | الدقيقة القوسية Q209426 | 1 |
0.00027777777777778 (1/3600°) | الثانية القوسية Q829073 | 1 |
0.000027777777777778 (1/36000° = 0.1″) | الثانية القوسية Q829073 | 0.1 |
- التحويل الأمامي: بالترتيب الدرجة، ثم الدقيقة القوسية (×60)، ثم الثانية القوسية (×3600)، يُتخذ أقرب binary32 إلى حاصل ضرب precision في عدد الوحدات قيمةً لـ Uncertainty، وتُستخدم أول وحدة يعيد التحويل العكسي أدناه بها precision الأصلية كما هي.
- التحويل العكسي: يُقسم أقصر تمثيل عشري لـ Uncertainty (أقصر عدد يُقرأ من جديد على أنه ذلك binary32) على عدد الوحدات ليتحول إلى درجات، ويُكتب بالطريقة التي يكتب بها ويكي بيس في الـ dump (14 رقماً معنوياً، وما دون
1e-4بالصيغة الأسية1.0e-6و2.7777777777778e-5). أما قاعدة البيانات المحمّلة (jsonb) فتحفظه بالصيغة العشرية0.0000010و0.000027777777777778. - إذا لم تعد أي وحدة الصيغة الأصلية (صيغة من 17 رقماً معنوياً مثل
0.0002777777777777778، أو قيم شاذة تبدو ناتجة عن حساب، وغيرها) فلا تُحوَّل الإحداثية كلها بل يُحفظ النص الأصلي بصيغة UTF8-TEXT. وكذلك precision السالبة والقيمة التي يكون فيها الجرم فارغاً. - عينة ويكي بيانات Q1–Q10000 (7,026 ادعاءً إحداثياً، منها 6,824 فيها precision): أُعيدت الصيغة الأصلية في 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)، Latitude404A 4222 2222 2251، Longitude402A C444 4444 4389، Uncertainty3F80 0000(binary32 يساوي 1.0)، Unit0142 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.
مسائل مفتوحة
- الارتفاع.
- صيغة تحفظ النص الأصلي لسلسلة ISO 6709 (COORDINATE-ISO6709) تُحدَّد عند ظهور حاجة إليها.
- طريقة لنقل صيغة 17 رقماً معنوياً لـ precision في ويكي بيانات (نحو 11% من العينة) دون فقد.
صفحات ذات صلة
- Value، COORDINATE-GEO، BINARY-FLOAT، علامة الموضع
- صيغة Issuer POINT2-BINARY64 نقطة ثنائية الأبعاد عامة تترك نظام الإحداثيات والوحدة ومعنى المحاور للسياق الخارجي، أما هذه الصيغة فهي إحداثية جغرافية على الأرض.
نص مستند المواصفة
هذا ما يظهر عند قراءة مستند المواصفة 0x00000000/codecs/0x00000640/latest.geul بالأمر geul show (الأرقام الستة عشرية بأحرف كبيرة).
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