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

تجميع النقاط حسب الشبكة

يحوّل تجميع النقاط حسب الشبكة قائمة طويلة من الإحداثيات إلى ملخص كثافة موجز من دون تشغيل نموذج تكراري.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

اختاروا حجم شبكة يلائم سؤالكم

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

اقرؤوا الأعداد والحدود والعضوية

تتضمن كل خلية رقم صف ورقم عمود يبدأان من الصفر، وحدود الجنوب والغرب والشمال والشرق، وقيمة count، وقائمة member_indices. تشير هذه الفهارس إلى المواضع في مصفوفة points المرسلة بدءاً من الصفر، كي تستعيدوا سجلات المصدر من دون نسخ التسميات إلى النتيجة. ترتب الخلايا من الجنوب إلى الشمال ثم من الغرب إلى الشرق، ويحافظ الأعضاء على ترتيب الإدخال. تدخل الإحداثية الواقعة على حد داخلي في الخلية الواقعة شمال ذلك الحد أو شرقه مباشرة. ويُسند خط العرض 90 وخط الطول 180 إلى آخر صف أو عمود صالح. تؤكد point_count عدد السجلات المعالجة، وتبين occupied_cell_count العدد المضغوط للخلايا غير الفارغة. تُحذف الخلايا الفارغة كي لا تتكون شبكة عالمية ضخمة. قد تكون الخلية الأخيرة في الشمال أو الشرق أضيق عندما لا يقسم الحجم 180 أو 360 تماماً. استخدموا الحدود المعادة عند رسم المستطيلات أو إعداد التقارير بدلاً من إعادة بنائها بحسابات فاصلة عائمة غير مدققة.

أنشئوا مسارات كثافة وتقسيم قابلة للتكرار

يعد التجميع الشبكي خطوة أولى عملية للخرائط وتدفقات المستشعرات ووقائع التسليم والمشاهدات الميدانية وفحوص جودة الإحداثيات. يستغرق الإسناد زمناً خطياً، ثم ترتب الخلايا المشغولة فقط ترتيباً ثابتاً، ولذلك يناسب الحالات التي يكون فيها جدول كثافة سريع أهم من اكتشاف أشكال غير منتظمة. يمكن للوحة معلومات تلوين كل مستطيل حسب العدد، ويمكن لمسار بيانات توجيه السجلات بالصف والعمود، كما تستطيع الاختبارات مقارنة الخلايا بين الإصدارات، ويستطيع المحلل تطبيق طريقة أعلى تكلفة على المناطق الكثيفة وحدها. لا تحسب الخوارزمية المراكز أو المسافات أو التجاور أو عتبات الكثافة، ولا تدمج الخلايا المتجاورة. كذلك لا تحوّل أسماء الأماكن إلى إحداثيات، ولا تصلح الإحداثيات المتبادلة، ولا تطبع خطوط الطول، ولا تحكم على السجلات المكررة. تُرفض القيم غير الصالحة. لدمج الدفعات، استخدموا cell_size نفسه واجمعوا أعداد الصفوف والأعمدة المتطابقة. الاستخدام التفاعلي مجاني، وتكلفة طلب API الناجح هي $0.002. تعطي مدخلات JSON المتطابقة نتائج متطابقة دائماً لعدم استخدام الشبكة أو العشوائية أو الساعة أو حالة مشتركة قابلة للتغيير.

أنشئوا طبقة كثافة للخريطة

حوّلوا إحداثيات الأحداث إلى مستطيلات مشغولة ولوّنوا كل خلية وفق عدد النقاط المعاد.

قسّموا سجلات المواقع

استخدموا معرفات الصف والعمود الثابتة لتوجيه السجلات المتقاربة إلى أقسام قابلة للتكرار.

افحصوا مجموعة مكانية كبيرة

اعثروا سريعاً على المناطق الكثيفة والمتناثرة قبل تطبيق تحليل المسافة على أجزاء مختارة.

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

يكلف طلب API الناجح $0.002. ويمكنكم أيضاً تشغيل الحساب الحتمي نفسه مجاناً في المتصفح.

هل يقاس حجم الخلية بالكيلومترات؟

لا. يقاس بالدرجات العشرية لخطوط العرض والطول، ولذلك يتغير العرض الفعلي مع خط العرض.

أين ترتكز الشبكة؟

تبدأ الصفوف عند خط العرض -90 والأعمدة عند خط الطول -180. ولا تتغير المرساة بين الطلبات.

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

تدخل نقطة الحد الداخلي في الخلية الشمالية أو الشرقية. ويدخل خط العرض 90 وخط الطول 180 في آخر خلية صالحة.

هل تعاد الخلايا الفارغة؟

لا. تعاد الخلايا المشغولة وحدها كي تظل نتائج الشبكات الدقيقة موجزة.

هل تكتشف الأداة مجموعات غير منتظمة أو قائمة على المسافة؟

لا. تحسب النقاط داخل خلايا زاوية ثابتة ولا تدمج الخلايا المجاورة أو تحسب المسافات بين النقاط.

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

POSThttps://api.kit.forhosting.com/geo/point-cluster-grid

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

curl -X POST https://api.kit.forhosting.com/geo/point-cluster-grid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[{"lat":40.7128,"lon":-74.006},{"lat":40.7306,"lon":-73.9352},{"lat":34.0522,"lon":-118.2437}],"cell_size":1}'
{
  "points": [
    {
      "lat": 40.7128,
      "lon": -74.006
    },
    {
      "lat": 40.7306,
      "lon": -73.9352
    },
    {
      "lat": 34.0522,
      "lon": -118.2437
    }
  ],
  "cell_size": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.point_cluster_grid",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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