ForHosting KIT · السفر والجغرافيا

الصندوق المحيط لجيوهاش

الجيوهاش 9q8yy يقابل خلية من 37.749023438 إلى 37.79296875 في خط العرض ومن -122.431640625 إلى -122.387695312 في خط الطول، ومركزها (37.770996094، -122.4096679685). الصق أي جيوهاش من 1 إلى 12 حرفًا لتحصل على الصندوق والزوايا والمركز. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

سلسلة جيوهاش: 9q8yy

تحصل على

الدقة: 5

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

ما الصندوق المحيط للجيوهاش وكيفية تمرير السلسلة

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

يسهم كل حرف بخمس بتات؛ تتناوب البتات بين خط الطول وخط العرض، وكل بت يختار النصف الأدنى أو الأعلى من الفترة الحالية. بعد استهلاك جميع الأحرف، تكون الفترة المتبقية هي الخلية التي يحددها الجيوهاش بشكل فريد. تُتجاهل حالة الأحرف ويعيد الرد قيمة منسّقة بأحرف صغيرة.

يتراوح الطول من حرف واحد إلى اثني عشر حرفًا: الهاشات القصيرة تغطي مناطق واسعة تصلح للمرشحات الخشنة، بينما تضيّق الهاشات الطويلة الصندوق حتى خلايا بمستوى الشارع.

قراءة حقول bbox والزوايا والمركز والدقة

الزوايا المريحة sw وne وnw وse تعيد صياغة المديات نفسها كأزواج من خطوط العرض والطول لمكتبات الخرائط التي تتوقع علامات الجنوب الغربي والشمال الشرقي أو رؤوس المضلعات. حقل center هو نقطة المنتصف الحسابية لفترتي خط العرض والطول، وهو الموضع المعتاد لدبوس الخريطة عندما تحتاج نقطة واحدة داخل الخلية. استخدم bbox وحده عند بناء مرشحات SQL BETWEEN أو استعلامات R-tree؛ واستخدم الزوايا عند رسم مستطيل متراكب؛ واستخدم center عند إسقاط علامة واحدة لموقع مجزّأ من عمود قاعدة بيانات.

الدقة تخبرك بمدى خشونة الخلية: حرف واحد يمتد عبر شريحة قارية ضخمة، بينما تبلغ ثمانية أحرف أو أكثر غالبًا مستوى الحي بحسب خط العرض. إخفاقات التحقق لا تختلق إحداثيات أبدًا؛ بل تفشل بشكل مغلق حتى لا تتسع الوصلات المكانية بصمت.

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

مرشحات قواعد البيانات المكانية

حوّل مفاتيح الجيوهاش المخزنة إلى نطاقات دنيا وقصوى لخطوط العرض والطول لبنود BETWEEN وتحميل البلاطات ومجموعات المرشحين الخشنة قبل فحص دقيق للمسافة.

تصحيح الخرائط والتعليم

الصق جيوهاشًا من السجلات أو الواجبات وشاهد فورًا مستطيل الخلية وزواياها ومركزها دون تثبيت حزمة نظم معلومات جغرافية مكتبية.

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

كيف أحصل على صندوق محيط من جيوهاش؟

يتضمن الرد bbox بحدّي العرض والطول الأدنى والأقصى إضافة إلى نقاط الزوايا والمركز.

ما الأحرف المسموح بها في الجيوهاش؟

الأرقام 0-9 والأحرف bcdfghjkmnpqrstuvwxyz (دون تمييز حالة الأحرف). الأحرف a وi وl وo غير مستخدمة.

هل تُرمّز هذه القدرة الإحداثيات في جيوهاش؟

لا. هذه القدرة تفك فقط ترميز جيوهاش موجود إلى صندوقه المحيط في WGS84. ترميز lat/lon منتج منفصل.

ما أطوال الدقة المدعومة؟

سلاسل جيوهاش من 1 إلى 12 حرفًا. السلاسل الأطول تُنقّي الخلية؛ وprecision في الرد يساوي عدد الأحرف بعد التنسيق.

فيمَ تُستخدم نقطة المركز؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/geohash-bbox

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

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

curl -X POST https://api.kit.forhosting.com/geo/geohash-bbox \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"geohash":"9q8yy"}'

const res = await fetch("https://api.kit.forhosting.com/geo/geohash-bbox", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "geohash": "9q8yy"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/geohash-bbox",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "geohash": "9q8yy"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"geohash":"9q8yy"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/geohash-bbox", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "geohash": "9q8yy"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.geohash_bbox",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

الخوارزمية تنصيف حتمي خالص بلا أي اتصالات شبكية، لذا يمكن لأنظمة الخرائط الخلفية وأدوات اللوجستيات وخطوط أنابيب نظم المعلومات الجغرافية تثبيت JSON في الاختبارات.

ما الصندوق المحيط للجيوهاش وكيفية تمرير السلسلة

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

قراءة حقول bbox والزوايا والمركز والدقة

عند النجاح يتضمن الرد geohash وprecision يساوي عدد الأحرف وكائن bbox يحوي min_lat وmin_lon وmax_lat وmax_lon بالدرجات العشرية. هذه الأرقام الأربعة هي المدى المغلق في WGS84 للخلية بعد تنصيف البتات، مقرّبة إلى عدد ثابت من الخانات يزداد بلطف مع الدقة حتى تبقى القيم ملائمة لـ JSON دون ضجيج دقة زائفة. التسمية method تكون دائمًا geohash_base32_bisection حتى يتمكن الكود اللاحق من التحقق من الخوارزمية دون تخمين البنى.

استخدام API والتسعير وسير عمل الخرائط والحدود العملية

اقرن هذه النقطة الطرفية بخطوات الترميز الجغرافي العكسي أو جلب البلاطات في بنيتك الخاصة عندما تحتاج أسماء الأماكن أو الصور: هذا المنتج يوسّع هندسة الهاش فقط. تخضع المدخلات لقواعد الاحتفاظ نفسها مثل عناصر parse الأخرى في KIT، والنتائج آمنة للتثبيت في تركيبات التكامل المستمر لأن التنصيف حتمي تمامًا. أرسل جسم JSON يتضمن سلسلة geohash الإلزامية واستخدم أداة الصندوق المحيط للجيوهاش المجانية داخل المتصفح للتعليم وتصحيح الهاشات المخزنة والفحوصات البصرية السريعة دون تثبيت مكتبات جغرافية مكانية. استخدم API المدفوعة مسبقًا عندما تحتاج منصة لوجستية أو موجّه توصيل أو ذاكرة بلاطات مؤقتة أو خط أنابيب تحليلات إلى عقد مستقر برصيد KIT بقيمة $0.002 لكل عنصر ناجح؛ ولا تستهلك إخفاقات التحقق أي رصيد بعد أن يرفض المحرك الطلب. الطول محدود باثني عشر حرفًا لتغطية دقات الخرائط العملية مع إبقاء عمل عزل Worker محدودًا. يمكن للمؤلفين الذين يصدرون SDK تعيين min_lat وmax_lon مباشرة في منشئات LatLngBounds في Leaflet وMapLibre وGoogle Maps — المستطيل نفسه الذي تحسبه أي مكتبة جيوهاش قياسية عندما توفر API للصندوق المحيط.

حالات التكامل

خطوط أنابيب اللوجستيات وإنترنت الأشياء

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

أسئلة تقنية

هل حاسبة الصندوق المحيط للجيوهاش مجانية؟

أداة المتصفح تعمل مجانًا على جهازك. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بقيمة $0.002 لكل عنصر ناجح؛ ولا تُحتسب رسوم على إخفاقات التحقق.

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

شغّل الأداة مجانًا

مثال محلول

ما الصندوق المحيط للجيوهاش وكيفية تمرير السلسلة

قراءة حقول bbox والزوايا والمركز والدقة

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

مرشحات قواعد البيانات المكانية

تصحيح الخرائط والتعليم

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

ما الصندوق المحيط للجيوهاش وكيفية تمرير السلسلة

قراءة حقول bbox والزوايا والمركز والدقة

استخدام API والتسعير وسير عمل الخرائط والحدود العملية

حالات التكامل

خطوط أنابيب اللوجستيات وإنترنت الأشياء

أسئلة تقنية

شكرًا