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

مربع إحاطة نقطة-نصف قطر

نصف قطر 5000 م حول 40.7128، −74.006 يصبح الحدود الدنيا والقصوى لخطوط العرض والطول لمربع يحيط بالدائرة كلها، جاهزًا لتصفية سريعة بالنطاقات قبل التحقق من المسافة الدقيقة. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

خط العرض: 40.7128
خط الطول: ‎-74.006
نصف القطر: 5,000

تحصل على

نصف القطر م: 5,000
نصف قطر الأرض م: 6,371,000
فرق العرض (درجة): 0.0449660803
أدنى عرض: 40.6678339197

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

ما مربع الإحاطة نقطة-نصف القطر ومتى تحتاجه

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

يستخدم التحويل أرضًا كروية بنصف قطر متوسط 6,371,000 متر: نصف القطر الزاوي هو نصف القطر الفيزيائي مقسومًا على ذلك الثابت؛ نصف عرض خط العرض هو تلك الزاوية بالدرجات؛ نصف عرض خط الطول هو نفس الزاوية مقسومة على جيب تمام خط عرض المركز لتبقى الأمتار متساوية تقريبًا في الامتداد شرقًا-غربًا.

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

نصائح عملية وحدود وعمليات بحث ذات صلة

فضّل الأمتار لنصف القطر كيلا يخلط العملاء الكيلومترات والأميال القانونية؛ حوّل الكيلومترات بالضرب في ألف قبل الاستدعاء. أبقِ المركز داخل نطاقات خط العرض والطول المنشورة؛ لا ترسل إحداثيات web-mercator أو مسقطة. تذكّر أن مربع درجات محاذي للمحاور مرشح مسبق: نقاط زوايا المستطيل قد تكون أبعد من نصف القطر عن المركز، فنقّح بـ haversine أو مسافة جيوديسية إن احتجت قطعًا دائريًا صلبًا.

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

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

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

حوّل مركز متجر ونصف قطر التسليم بالأمتار إلى أدنى/أقصى lat/lon لبنود SQL BETWEEN، ثم نقّح بفحص مسافة حقيقي على القائمة القصيرة.

نافذة عرض الخريطة ونوافذ جلب البلاط مسبقًا

بإعطاء دبوس ومسافة حاجز، احسب مربع الإحاطة المستخدم لطلب بلاطات خريطة أو علامات أو ميزات Overpass دون تغطية ناقصة للدائرة.

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

بأي وحدات يُقاس نصف القطر؟

بالأمتار. حوّل الكيلومترات بالضرب في 1000 (مثل 5 km → 5000).

هل مربع الإحاطة هو نفسه الدائرة؟

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

لماذا يتسع المربع كثيرًا قرب القطبين؟

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

لماذا يُرفض نصف القطر السالب؟

لأن المسافة ذات الإشارة ليست نصف قطر بحث. وأخذ القيمة المطلقة بصمت سيخفي خطأ في النظام الذي أرسلها، لذلك يُرفض نصف القطر السالب بينما يُقبل نصف القطر صفر.

ما نموذج الأرض المستخدم؟

كرة بنصف قطر أرضي متوسط قدره 6371000 متر. ويساوي نصف القطر الزاوي نصف قطرك بالأمتار مقسومًا على هذا الثابت، ومنه يُشتق نصف الارتفاع في العرض ونصف الامتداد في الطول.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/bounding-box

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

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

curl -X POST https://api.kit.forhosting.com/geo/bounding-box \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":40.7128,"lon":-74.006,"radius":5000}'

const res = await fetch("https://api.kit.forhosting.com/geo/bounding-box", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "lat": 40.7128,
    "lon": -74.006,
    "radius": 5000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/bounding-box",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "lat": 40.7128,
    "lon": -74.006,
    "radius": 5000
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"lat":40.7128,"lon":-74.006,"radius":5000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/bounding-box", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "lat": 40.7128,
  "lon": -74.006,
  "radius": 5000
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`min_lat`	-90
`max_lat`	90
`min_lon`	-180
`max_lon`	180
`max_radius_m`	20037508.342789244

الأخطاء

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

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

أدخل خط العرض والطول بالدرجات العشرية للمركز، مع نصف قطر غير سالب بالأمتار؛ تعيد الأداة min_lat وmax_lat وmin_lon وmax_lon ومصفوفة bbox بأسلوب GeoJSON [west, south, east, north] وإزاحة زاوية لخط العرض وملاحظات خطوة بخطوة لنموذج كروي بنصف قطر أرض متوسط. تُرفض أنصاف الأقطار السالبة بـ invalid_input كيلا يرسل المستدعون نافذة بحث مقلوبة أو بلا معنى. المسار حساب حتمي نقي — بلا شبكة وبلا بذور عشوائية وبلا اعتماد على الساعة — فيعيد منفّذ المتصفح المجاني وواجهة API المدفوعة مسبقًا نفس JSON بعد التقريب العشري الثابت في كل استدعاء.

ما مربع الإحاطة نقطة-نصف القطر ومتى تحتاجه

عندما تعبر الحافة الغربية أو الشرقية الخام خط التاريخ، تُطبَّع خطوط الطول إلى الفترة المغلقة من سالب مائة وثمانين إلى موجبه ويُعلَّم علم أن min_lon قد يكون أكبر من max_lon بعد اللف — حالة خط التاريخ الكلاسيكية التي تعالجها مكتبات الخرائط أصلًا.

كيف تستدعي API وما الذي يعود

خط العرض والطول المطلقان خارج تلك الفترات المغلقة يفشلان في التحقق قبل أي حساب مثلثي. أرسل جسم JSON بثلاثة أعداد محدودة إلزامية: lat (أسماء بديلة latitude وcenter_lat) بالدرجات من سالب تسعين إلى تسعين، وlon (أسماء بديلة longitude وlng وcenter_lon) بالدرجات من سالب مائة وثمانين إلى مائة وثمانين، وradius (أسماء بديلة radius_m وr) بالأمتار، غير سالب ولا أكبر من نصف محيط الأرض. عند النجاح تعيد الاستجابة lat وlon وradius_m مقربة؛ وتضبط earth_radius_m على الثابت 6371000؛ وdelta_lat_deg على نصف عرض خط العرض بالدرجات؛ وmin_lat وmax_lat وmin_lon وmax_lon للمربع المحيط؛ وbbox على الرباعية min_lon وmin_lat وmax_lon وmax_lat بترتيب غرب-جنوب-شرق-شمال؛ والمنطقيين full_longitude وcrosses_antimeridian؛ وmessage إلى ملخص قصير؛ وsteps إلى مصفوفة مرتبة من أسطر الاشتقاق يمكنك عرضها في السجلات أو الواجهة. فشل التحقق — حقول ناقصة أو أعداد غير محدودة أو خط عرض أو طول خارج النطاق أو نصف قطر سالب أو مفرط — يعيد invalid_input ولا يُحسب أبدًا. التسعير flat $0.002 لكل طلب ناجح بوحدة item وسعر وحدة هامشي صفر.

نصائح عملية وحدود وعمليات بحث ذات صلة

قرب القطبين توقّع full_longitude صحيحًا لأنصاف أقطار معتدلة لأن درجات خط الطول تنكمش إلى صفر متر. لاستعلامات متمركزة على المحيط الهادئ قرب خط التاريخ، تحقق من crosses_antimeridian وقسّم الاستعلام إلى فترتي خط طول عندما لا تستطيع قاعدة بياناتك التعبير عن نطاق ملفوف. أمثلة مقترنة: نيويورك عند خط عرض نحو 40.71 وخط طول سالب 74.01 بنصف قطر خمسة كيلومترات لبحث متاجر على مقياس مدينة؛ واستدعاء بنصف قطر صفر يعيد أدنى وأعلى مساويين للمركز؛ ونصف قطر سالب عمدًا يوضح مسار invalid_input الصلب. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المدفوع مسبقًا، مما يبقي سكربتات الاستكشاف رخيصة عندما يرسل المتعلمون أنصاف أقطار سالبة عمدًا. فحوص الذهاب والإياب سهلة: عند خطوط عرض متوسطة أعد حساب فرق خط العرض كنصف قطر على R مضروبًا في مائة وثمانين على pi وتأكد أن min_lat وmax_lat يتطابقان ضمن التقريب المنشور إلى اثنتي عشرة منزلة.

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

اختبارات وحدات للسياج الجغرافي وواجهات API المكانية

ولّد حالات حتمية موجبة وصفرية وقطبية وسالبة لنصف القطر لتجهيزات golden في كود السياج الجغرافي المحمول والخلفي.

أسئلة تقنية

ماذا يحدث قرب القطبين أو خط التاريخ؟

إذا بلغت الدائرة قطبًا أو كان نصف عرض خط الطول 180° على الأقل، يكون full_longitude صحيحًا وتمتد خطوط الطول من −180 إلى 180. إذا لفّ المربع خط التاريخ، يكون crosses_antimeridian صحيحًا وقد يكون min_lon أكبر من max_lon بعد التطبيع.

أي نموذج أرض يُستخدم؟

كرة متوسطة بـ R = 6,371,000 m. هذا هو الافتراضي الشائع في GIS للأغلفة السريعة؛ وليس حاجزًا جيوديسيًا كاملًا لإهليلج WGS84.

هل حاسبة مربع الإحاطة نقطة-نصف القطر مجانية؟

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

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

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

مثال محلول

ما مربع الإحاطة نقطة-نصف القطر ومتى تحتاجه

نصائح عملية وحدود وعمليات بحث ذات صلة

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

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

نافذة عرض الخريطة ونوافذ جلب البلاط مسبقًا

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

ما مربع الإحاطة نقطة-نصف القطر ومتى تحتاجه

كيف تستدعي API وما الذي يعود

نصائح عملية وحدود وعمليات بحث ذات صلة

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

اختبارات وحدات للسياج الجغرافي وواجهات API المكانية

أسئلة تقنية

شكرًا