ForHosting KIT · أدوات المطورين

تحويل نقطة إلى خلية سداسية

حوّل إحداثيات نقطة مستوية إلى الخلية التي تحتويها ضمن شبكة سداسية منتظمة. أدخل النقطة وحجم الشكل السداسي، وحدد اتجاه الشبكة وأصلها عند الحاجة.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تعيد النتيجة فهرسين صحيحين للعمود والصف المحوريين، ويمكن استخدامهما مباشرة في الخرائط والألعاب والتجميع المكاني والتخطيطات الإجرائية وحسابات الجوار. يعتمد التحويل على التقريب في الإحداثيات المكعبة، ولذلك تُسند النقاط القريبة من الحواف والرؤوس بطريقة متسقة من دون فحص الخلايا واحدة تلو الأخرى أو إنشاء مضلعات هندسية.

عرّف الشبكة قبل تحديد خلية النقطة

تحتاج الشبكة السداسية المنتظمة إلى ثلاث معلومات قبل إسناد نقطة إلى إحدى خلاياها. أدخل أولًا الإحداثيين المستويين x وy ضمن نظام الإحداثيات نفسه الذي تستخدمه الشبكة. ثم اضبط size على المسافة من مركز الشكل السداسي إلى أي رأس من رؤوسه. هذه المسافة هي نصف قطر الدائرة المحيطة، وليست العرض الكامل أو الارتفاع أو المسافة بين ضلعين متقابلين أو بين مركزي خليتين. اختر بعد ذلك الاتجاه. تحتوي شبكة pointy على رأس في الأعلى وآخر في الأسفل، بينما تحتوي شبكة flat على ضلع أفقي في كل من الأعلى والأسفل. القيمة الافتراضية هي pointy. يكون مركز الخلية المحورية صفر، صفر افتراضيًا عند الإحداثي المستوي صفر، صفر. استخدم origin_x وorigin_y إذا كانت الشبكة مزاحة عن ذلك الموضع. يغيّر الأصل مكان الشبكة فقط، ولا يغيّر مقياسها أو اتجاهها أو طريقة فهرستها. يجب أن تستخدم جميع قيم الإحداثيات والحجم وحدة واحدة متسقة، مثل البكسل أو المتر أو وحدات الخريطة المسقطة. وإذا كنتم تحتاجون إلى شبكة مستوية فعلًا ومتسقة في المسافات، فحوّلوا خطوط الطول والعرض الجغرافية إلى إسقاط مناسب أولًا.

افهم النتيجة المحورية وطريقة التقريب

يمثل العمود والصف المعادان إحداثيين محوريين، ويشار إليهما عادة بالرمزين q وr في مراجع الشبكات السداسية. تستخدم الإحداثيات المحورية محورين صحيحين مع أن الحركة على الشبكة السداسية تتم في ستة اتجاهات. أما الإحداثي المكعب الثالث غير الظاهر فيساوي سالب مجموع الإحداثيين الأولين، وهذا يجعل عمليات المسافة والجيران والحلقات والمدى مباشرة. يحول الحساب النقطة داخليًا إلى إحداثيات محورية كسرية وفق الاتجاه المحدد. ثم يحول الكسور إلى إحداثيات مكعبة ويقربها مع الحفاظ على قيد الإحداثيات المكعبة، قبل إعادتها في صورة زوج محوري صحيح. هذه الخطوة مهمة لأن تقريب المحورين الظاهرين كل على حدة قد يختار خلية خاطئة قرب حد قطري. تنتمي النقطة الواقعة تمامًا على حافة أو رأس مشترك هندسيًا إلى أكثر من مضلع مغلق، لذلك تحتاج أي عملية إسناد إلى قاعدة لحسم التعادل. تحسم هذه الحاسبة الحالات المتعادلة بصورة حتمية باستخدام التقريب العددي في JavaScript وترتيب ثابت لتصحيح المكونات. بالنسبة إلى النقاط الداخلية، تكون النتيجة هي الخلية الوحيدة التي تحتوي النقطة؛ أما على الحدود الدقيقة، فتكون اختيارًا معياريًا ثابتًا قابلًا للتكرار.

استخدم فهارس الخلايا في الأنظمة المكانية

بعد حصول النقطة على عمود وصف محوريين، تستطيع التطبيقات تجميع عدد كبير من المشاهدات من دون تخزين مضلع كل شكل سداسي أو اختباره. يمكن للعبة تحويل موضع المؤشر إلى خلية في اللوحة، ويمكن لعرض بصري تجميع الأحداث المسقطة ضمن حاويات مكانية، كما يستطيع مولد إجرائي استخدام الزوج مفتاحًا ثابتًا للبلاطة. احتفظوا بتعريف الشبكة الأصلي مع الفهارس، لأن العمود والصف نفسيهما يحددان منطقة مادية مختلفة إذا تغير الحجم أو الاتجاه أو الأصل. عند معالجة عدة نقاط، استخدموا إعدادات شبكة متطابقة لكل عنصر، واجمعوا السجلات بمفتاح مثل العمود ثم فاصلة ثم الصف. الفهارس السالبة طبيعية؛ فهي تحدد ببساطة خلايا إلى يسار الأصل المحوري أو أعلاه أو أسفله وفق الاتجاه. تستغرق العملية وقتًا ثابتًا لكل نقطة، ولا تعتمد على الامتداد الكلي للشبكة. كما أنها لا تفرض حدًا مصطنعًا، ولذلك تناسب اللوحات المحدودة والشبكات غير المحدودة من الناحية النظرية. ولأغراض الرسم، استخرجوا مركز الخلية المختارة أو رؤوسها بواسطة صيغ التحويل المطابقة من الإحداثيات المحورية إلى المستوية، بدلًا من التعامل مع العمود والصف كأنهما إحداثيات بكسل مستطيلة.

حالات الاستخدام

اختيار بلاطة سداسية بالمؤشر

حوّلوا موضع الفأرة أو القلم أو اللمس إلى الخلية المحورية التي تستخدمها لوحة أو أداة تحرير أو لعبة استراتيجية.

تجميع مشاهدات خريطة مسقطة

أسندوا نقاط الخريطة المستوية إلى حاويات سداسية ثابتة قبل عد المشاهدات أو تلوينها أو تلخيصها.

فهرسة بيانات عالم إجرائي

حوّلوا الموضع إلى فهرسي عمود وصف صحيحين للوصول إلى تضاريس مولدة أو ذاكرة مؤقتة أو حالة محاكاة.

الأسئلة الشائعة

ماذا تعني size؟

تمثل Size المسافة من مركز الشكل السداسي إلى أي رأس من رؤوسه، وهي تساوي أيضًا طول الضلع في الشكل السداسي المنتظم.

ما الفرق بين الاتجاهين pointy وflat؟

للأشكال السداسية pointy رأسان في الأعلى والأسفل، بينما توجد في أشكال flat حافتان أفقيتان هناك. تختلف معادلة تحويل الإحداثيات بينهما.

هل يمكن أن يكون العمود أو الصف سالبًا؟

نعم. تمتد الإحداثيات المحورية في جميع الاتجاهات انطلاقًا من الخلية صفر، صفر، ولذلك تكون الفهارس السالبة نتائج طبيعية.

ماذا يحدث إذا وقعت النقطة تمامًا على حد خلية؟

يطبق تقريب الإحداثيات المكعبة قاعدة حتمية لحسم التعادل، ويعيد إحدى الخلايا التي تشترك في تلك الحافة أو ذلك الرأس.

هل يمكن إدخال خط الطول وخط العرض مباشرة؟

يقبل الحساب أرقامًا، لكنه يفترض نظام إحداثيات مستويًا. حوّلوا الإحداثيات الجغرافية إلى إسقاط مناسب أولًا عندما تكون دقة المسافات والمساحات مهمة.

ما تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن تنفيذ الحساب الحتمي نفسه داخل المتصفح أيضًا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/hex-grid-cell

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/geo/hex-grid-cell \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x":18,"y":9,"size":10}'

const res = await fetch("https://api.kit.forhosting.com/geo/hex-grid-cell", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "x": 18,
    "y": 9,
    "size": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/hex-grid-cell",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "x": 18,
    "y": 9,
    "size": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/hex-grid-cell", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"x":18,"y":9,"size":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"x":18,"y":9,"size":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/hex-grid-cell", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "x": 18,
  "y": 9,
  "size": 10
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.hex_grid_cell",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←