أداة البحث عن خلايا جيوهاش المجاورة
أدخل رمز جيوهاش واحدًا واحصل على الخلايا الثماني المحيطة به من الشمال إلى الشمال الغربي: فالرمز u4pruyd شماله u4pruyf وشرقه u4pruye، وكلها بعدد الأحرف نفسه. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- سلسلة جيوهاش
- u4pruyd
- الدقة
- 7
- N
- u4pruyf
- NE
- u4pruyg
- E
- u4pruye
تحوّل أداة البحث عن خلايا جيوهاش المجاورة معرّف خلية واحدة إلى الخلايا الثماني التي تتشارك معها حدّاً أو زاوية. الصق جيوهاش base32 — بأي دقة من حرف واحد إلى اثني عشر حرفاً — وتسير الأداة عبر جداول الجوار الكلاسيكية للأطوال الزوجية والفردية لتُخرج الشمال والشمال الشرقي والشرق والجنوب الشرقي والجنوب والجنوب الغربي والغرب والشمال الغربي بالطول نفسه. كثيراً ما تحتاج الفهارس المكانية وذاكرات القرب المؤقتة وبلاطات الخرائط إلى جوار Moore هذا دون فكّ ترميز كل خلية إلى خط عرض وخط طول أولاً.
ماذا يعني التجاور في جيوهاش على الشبكة
يُرمّز الجيوهاش مستطيل خط عرض وخط طول على شكل سلسلة base32 قصيرة عبر تشابك بتّات خط الطول وخط العرض وتجميعها في أحرف من خمس بتات. الخلايا المجاورة بالدقة نفسها هي مستطيلات جوار Moore الثمانية التي تلامس الخلية المركزية عند حدّ أو زاوية. ولأن البتّات تتناوب بحسب الزوجية، فإن الحرف الواقع شمال الحرف الأخير مباشرة لا يتبع الجدول نفسه عندما يكون طول السلسلة زوجياً مقارنة بالفردي؛ لذلك تحتفظ أدوات تتبّع الجوار بجودة الإنتاج بسلسلتي بحث لكل اتجاه، إضافة إلى جدول حواف يبيّن متى يفرض الحرف الأخير خطوة إلى مستوى الأصل.
الجاران الشرقي والغربي يلتفّان حول خط الزوال المضاد، فتكون للخلية الواقعة عند الحافة اليمنى من الكرة الأرضية جارة شرقية منطقية عند الحافة اليسرى. الشمال والجنوب لا يلتفّان عبر القطبين: إذا كانت الخلية أصلاً عند الحافة الشمالية أو الجنوبية للشبكة العالمية، فإن طلب خطوة إضافية في ذلك الاتجاه خارج النطاق وترفضه هذه الأداة. تُحفظ الدقة من البداية إلى النهاية — إن مرّرت سبعة أحرف حصلت على جيران من سبعة أحرف — بحيث يمكنك ضمّ مجموعة النتائج مباشرة إلى عائلة حاويات الفهرس نفسها دون إعادة ترميز.
هذا العقد هو ما تحتاجه فعلاً خوادم الخرائط الخلفية وموسّعات نطاق التوصيل واختبارات الوحدة لمكتبات جيوهاش عندما توسّع خلية إلى حلقتها المكوّنة من ثمان.
نصائح عملية وحدود وعمليات بحث ذات صلة
أبقِ الدقة ضمن النطاق المنشور من حرف واحد إلى اثني عشر حرفاً؛ فالبصمات الأطول مرفوضة كي تبقى مسارات الأصل الوسيطة محدودة وتظل النتائج متوافقة مع إعدادات المكتبات الشائعة الافتراضية. عند بناء حلقة k أكبر من الثمانية المباشرة، استدعِ هذه الأداة على كل خلية حدودية وأزل التكرارات — فالقدرة نفسها لا تُرجع سوى الحلقة الأولى ليبقى السلوك بسيطاً وقابلاً للتخزين المؤقت.
تستهدف هذه الصفحة من يبحثون عن جيران جيوهاش أو الخلايا المجاورة لجيوهاش أو أداة بحث جيوهاش شمال-جنوب-شرق-غرب؛ فهي ليست مُرمّزاً لخط العرض وخط الطول، ولا مفكّك ترميز إلى مربعات إحاطة، ولا بحثاً بنصف قطر بالكيلومترات. فضّل هذه القدرة عندما تملك أصلاً سلسلة جيوهاش ولا تحتاج إلا إلى الجيران الثمانية بالدقة نفسها؛ أما إذا كان مصدرك زوجاً من الإحداثيات، فرمّز أولاً بمُرمّز مخصص ثم وسّع.
فحوصات الذهاب والإياب سهلة: اختر عيّنة معروفة مثل dqcjq، وتأكد من تطابق الجيران الثمانية مع مكتبة موثوقة، ثم تحقق من أن حرفاً غير صالح مثل الحرف a يفشل دائماً برمز الخطأ الموثّق.
حالات الاستخدام
توسيع خلية لاستعلامات القرب
تستعلم الخدمات الخلفية التي تفهرس النقاط بجيوهاش عن الخلية المركزية وجيرانها الثمانية لالتقاط النقاط التي تقع مباشرة خلف حدود الخلية.
حلقات بلاطات الخرائط والخرائط الحرارية
توسّع خطوط أنابيب العرض المرئي جيوهاشاً محدداً إلى جوار Moore لإبراز البلاطات المجاورة دون فكّ ترميز كل خلية إلى خط عرض وطول أولاً.
الأسئلة الشائعة
ماذا تُرجع أداة جيران جيوهاش هذه؟
الخلايا الثماني المجاورة بالدقة نفسها: الشمال والشمال الشرقي والشرق والجنوب الشرقي والجنوب والجنوب الغربي والغرب والشمال الغربي، إضافة إلى كائن neighbors وقائمة مرتبة والدقة.
هل يلتفّ الشرق والغرب حول الكرة الأرضية؟
نعم. يلتفّ خط الطول عند خط الزوال المضاد.
هل تُرمّز هذه الأداة خط العرض وخط الطول أو تفكّ ترميزهما؟
لا. هي توسّع فقط سلسلة جيوهاش موجودة إلى خلاياها الثماني المجاورة بالدقة نفسها.
لماذا أبحث في الخلايا المجاورة وليس في رمز جيوهاش واحد فقط؟
قد تقع نقطتان متقاربتان جدًا على جانبي حد الخلية فتحصلان على رمزين مختلفين. وعند البحث في الخلية المركزية وجاراتها الثماني تُلتقط هذه النقاط، فلا يفوت البحث عن القريب أي نتيجة مجاورة.
هل تحمل الخلايا المجاورة عدد أحرف الرمز الأصلي نفسه؟
نعم. إذا أدخلت سبعة أحرف حصلت على ثمانية جيران من سبعة أحرف لكل منها، فيمكن ضمّ النتائج مباشرة إلى الفهرس نفسه دون إعادة ترميز أي شيء.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/geo/geohash-neighbors \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"geohash":"u4pruyd"}'const res = await fetch("https://api.kit.forhosting.com/geo/geohash-neighbors", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"geohash": "u4pruyd"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/geohash-neighbors",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"geohash": "u4pruyd"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/geohash-neighbors", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"geohash":"u4pruyd"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"geohash":"u4pruyd"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/geohash-neighbors", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"geohash": "u4pruyd"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.geohash_neighbors",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_precision | 12 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
الأحرف خارج الأبجدية والسلاسل الفارغة والدقة المفرطة والخطوات شمالاً أو جنوباً عند الحافة القطبية تُرجع خطأ invalid_input واضحاً بدلاً من خلية خاطئة بصمت. المسار حساب سلاسل نصية حتمي خالص — بلا شبكة وبلا بذور عشوائية وبلا اعتماد على الساعة — لذا يُرجع المُشغّل المجاني في المتصفح وواجهة API المدفوعة مسبقاً JSON نفسه في كل مرة تستدعيهما فيها بالجيوهاش نفسه.
كيفية استدعاء API وما الذي يعود به
يجب أن تتألف القيمة من حرف واحد إلى اثني عشر حرفاً من أبجدية base32 الخاصة بجيوهاش: الأرقام من صفر إلى تسعة والأحرف b c d e f g h j k m n p q r s t u v w x y z — فالأحرف a وi وl وo غائبة عمداً وستفشل في التحقق. تُزال المسافات البادئة واللاحقة وتُحوَّل الأحرف إلى صغيرة قبل المعالجة، حتى لا يُنشئ إدخال العميل بأحرف مختلطة الكبرى والصغرى بصمتين للخلية نفسها. عند النجاح، تُعيد الاستجابة الجيوهاش المُطبَّع ودقّته، وتُرجع كائناً neighbors بمفاتيح n وne وe وse وs وsw وw وnw، وتكرر تلك السلاسل الثماني كحقول من المستوى الأعلى للمستهلكين المسطّحين، وتوفر list كمصفوفة مرتبة بالقيم الثماني نفسها، وتضبط count على ثمانية، وتتضمن رسالة إنجليزية قصيرة. أرسل جسم JSON يتضمن حقلاً نصياً واحداً إلزامياً هو geohash (بالاسمين المستعارين hash وgh). فشل التحقق — حقل مفقود أو قيمة غير نصية أو فراغ بعد الإزالة أو حرف غير مشروع أو دقة تتجاوز اثني عشر أو خطوة شمالية أو جنوبية عند الحافة القطبية — يُرجع invalid_input ولا يُحتسب أبداً. التسعير سعر ثابت قدره $0.002 لكل طلب ناجح مع بند وحدة وسعر وحدة هامشي صفري.
نصائح عملية وحدود وعمليات بحث ذات صلة
فضّل اسم الحقل الرئيسي geohash في العملاء الجدد؛ فالاسمان المستعاران hash وgh موجودان لإرسالات النماذج القصيرة والمقتطفات القديمة. الحواف القطبية نادرة عند دقة مستوى المدينة، لكنها تظهر في البصمات أحادية الحرف وبعض ثنائية الحرف قرب القطبين؛ تعامل هناك مع invalid_input كحدّ صارم بدلاً من اختلاق خلية معكوسة. المهام الفاشلة التي تُرجع invalid_input لا تستهلك الرصيد المدفوع مسبقاً، مما يُبقي النصوص الاستكشافية رخيصة عندما تختبر أبجديات غير صالحة عن قصد.
حالات التكامل
اختبارات الوحدة لمكتبات جيوهاش
أنشئ خرائط جوار متوقعة وحتمية للدقة الزوجية والفردية، إضافة إلى حالات رفض الأبجدية غير الصالحة والحافة القطبية، لتدريبات البرمجة وملفات golden للمكتبات.
أسئلة تقنية
ما الأحرف الصالحة في الجيوهاش؟
أرقام base32 من 0–9 والأحرف bcdfghjkmnpqrstuvwxyz. الأحرف a وi وl وo غير مستخدمة وتُطلق invalid_input.
هل أداة البحث عن جيران جيوهاش مجانية؟
أداة المتصفح مجانية وتعمل محلياً. أما استدعاءات API فتستخدم رصيد KIT المدفوع مسبقاً بمقدار $0.002 لكل طلب ناجح؛ والمهام الفاشلة لا تُحتسب أبداً.