فهرس H3 سداسي تقريبي لتحويل الإحداثيات إلى خلية
تُسند أداة فهرس H3 السداسي التقريبي هذه إحداثية من خط العرض والطول إلى خلية ثابتة ضمن شبكة سداسية عالمية ذات رؤوس متجهة إلى الأعلى.
شغّل الأداة مجانًا
يمكنكم اختيار دقة من 0 إلى 15 للانتقال من مناطق واسعة إلى خلايا أدق تدريجياً. تتضمن النتيجة معرّف خلية مقروءاً، وإحداثيات محورية، ومركزاً مقدّراً، وطول ضلع تقريبياً. صُممت الأداة للتجميع والتقسيم والتخزين المؤقت والعروض الخفيفة التي تكون فيها الخلايا الحتمية أهم من التوافق الدقيق مع نظام H3 الرسمي.
اختاروا دقة تناسب مهمة التجميع
تتحكم الدقة في مقياس الشبكة. تنتج الدقة 0 خلايا واسعة جداً، ويقسم كل مستوى أعلى طول الضلع الزاوي إلى النصف. لذلك يكون التدرج متوقعاً: قد تنتمي نقاط متقاربة ومنفصلة في مستوى ما إلى خلية واحدة في مستوى أخشن، بينما تنشئ الدقة الأعلى مجموعات أكثر تفصيلاً. ابدؤوا بدقة منخفضة عند تلخيص النشاط عبر مناطق كبيرة، ثم ارفعوها للتجميع على مستوى الأحياء أو للعرض الكثيف. يوفر طول الضلع التقريبي مرجعاً عملياً للمقياس، لكنه ليس ضماناً جيوديسياً. تستخدم الشبكة إسقاطاً متساوي المستطيلات بسيطاً، ولذلك تتناقص المسافات الأرضية شرقاً وغرباً كلما اقتربنا من القطبين، مع بقاء الهندسة الزاوية منتظمة. اختبروا إحداثيات تمثل المنطقة الفعلية المراد تحليلها بدلاً من اختيار المستوى بالاعتماد على تقدير الضلع وحده. والأهم أن تحفظوا الدقة مع كل فهرس، إذ لا تمثل الخلايا ذات الدقات المختلفة المساحة نفسها.
افهموا كيفية إنشاء الفهرس التقريبي
تضع الخوارزمية خط الطول على محور أفقي وخط العرض على محور رأسي، ثم تضيف شبكة سداسية ذات رؤوس متجهة إلى الأعلى، وتحول النقطة إلى إحداثيات محورية كسرية، وتقربها باستعمال إحداثيات مكعبية. يحافظ هذا التقريب على العلاقة بين المحاور الثلاثة للشبكة السداسية، ويمنح كل إدخال صالح خلية حتمية واحدة فقط. يحتوي المعرّف على السابقة ah3 والدقة المختارة ورموز base-36 موقعة للإحداثيين q وr. ومن ثم ينتج الإدخال نفسه النتيجة نفسها من دون اتصال شبكي أو حالة مخزنة أو عشوائية أو بيانات مرتبطة بالوقت. يُحسب المركز المعاد بتحويل الموضع المحوري المقرب إلى خط العرض والطول، وهو مفيد للعنونة وتصحيح الأخطاء ووضع علامة تمثيلية. تستحق النقاط الحدية عناية خاصة، فقد يؤدي تغير ضئيل قرب ضلع سداسي إلى اختيار خلية مجاورة، وهذا سلوك متوقع في أي فهرس مكاني. استخدموا الدقة الكاملة لإحداثيات المصدر عندما تكون قابلية التكرار قرب الحدود مهمة.
اعرفوا متى تستخدمون هذه الشبكة أو H3 الرسمي
تحاكي هذه القدرة سير عمل H3 عن قصد، لكنها لا تدعي توافقاً ثنائياً أو نصياً أو هندسياً أو هرمياً مع فهارسه. وهي شبكة تحليلية مدمجة للحالات التي تحتاجون فيها إلى مجموعات مكانية قابلة للتكرار من دون تحميل مكتبة جغرافية مكانية متخصصة. تناسب تجميع المواقع النموذجية وتقسيم مفاتيح التخزين المؤقت وإنتاج إحصاءات كثافة عامة وتعليم الإحداثيات المحورية وإنشاء بيانات اختبار ثابتة. تكون قيمة الحقل compatible_with_h3 دائماً false كي لا يخلط أي نظام لاحق النتيجة بعنوان H3 رسمي. استخدموا مكتبة H3 الرسمية عند تبادل الفهارس مع تطبيق آخر، أو اجتياز الآباء والأبناء الحقيقيين، أو استخراج حدود الخلايا القياسية، أو معالجة الأشكال الخماسية، أو الاعتماد على نموذج الأرض عشروني الوجوه الخاص بـ H3. تذكروا أيضاً أن هذا التقريب يستخدم خطي العرض والطول على سطح مستوٍ، لذلك تتشوه مساحة الخلايا الأرضية بحسب خط العرض ولا تتصل الخلايا عبر خط الزوال المقابل. تعاملوا معه كنظام تجميع حتمي لا بديلاً للتحليل الجيوديسي.
حالات الاستخدام
تجميع أحداث الخريطة
أسندوا الإحداثيات الواردة إلى مجموعات مكانية ثابتة قبل عد الأحداث أو تلخيصها.
إنشاء مفاتيح تخزين مؤقت مكانية
استخدموا سلسلة الخلية الحتمية ضمن مفتاح تخزين مؤقت لنتائج تعتمد تقريبياً على الموقع.
إنشاء نموذج أولي لخريطة سداسية
استكشفوا الدقات والإحداثيات المحورية قبل اعتماد مكتبة جغرافية مكانية متكاملة.
الأسئلة الشائعة
هل الخلية المعادة فهرس H3 صالح؟
لا. إنها معرّف تقريبي مستقل التعريف، وموسوم صراحة بأنه غير متوافق مع H3.
ماذا تعني الدقة؟
تحدد مستوى تفاصيل الشبكة من 0 إلى 15. تقسم كل زيادة الضلع الزاوي إلى النصف وتنشئ مجموعات أدق.
لماذا يتغير حجم الخلية على الأرض؟
يستخدم الحساب سطحاً متساوي المستطيلات، لذلك يغطي نطاق خط الطول نفسه أرضاً أقل باتجاه القطبين.
هل النتيجة حتمية؟
نعم. تنتج قيم خط العرض والطول والدقة المتطابقة النتيجة نفسها دائماً.
ما تكلفة الطلب الواحد؟
تبلغ تكلفة طلب API واحد $0.002. ويمكن لنسخة المتصفح تنفيذ الحساب النقي نفسه محلياً.
هل يمكن استخدام المركز بوصفه مركزاً جغرافياً دقيقاً؟
لا. إنه المركز المستوي للخلية التقريبية، وينبغي اعتباره إحداثية تمثيلية.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/geo/h3-cell-approx \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat":37.7749,"lon":-122.4194}'const res = await fetch("https://api.kit.forhosting.com/geo/h3-cell-approx", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat": 37.7749,
"lon": -122.4194
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/h3-cell-approx",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat": 37.7749,
"lon": -122.4194
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/h3-cell-approx", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat":37.7749,"lon":-122.4194}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat":37.7749,"lon":-122.4194}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/h3-cell-approx", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"lat": 37.7749,
"lon": -122.4194
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.h3_cell_approx",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |