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

حاسبة نقطة الوجهة

تجيب حاسبة نقطة الوجهة عن المسألة المباشرة للملاحة الكروية: إذا علمتَ أين تقف، والاتجاه الحقيقي الذي تغادر عليه، والمسافة التي تقطعها، فأين تصل؟ تأخذ هذه الأداة خط عرض وخط طول للبداية بالدرجات العشرية، واتجاهًا ابتدائيًا يُقاس مع عقارب الساعة من الشمال الحقيقي، ومسافة بالأمتار أو الكيلومترات أو الأميال القانونية أو الأميال البحرية، ثم تعيد وجهة الدائرة العظمى على كرة نصف قطرها هو متوسط نصف قطر الأرض، أو أي نصف قطر موجب مخصص تقدمه. لا تستخدم الصيغة سوى علم المثلثات الأولي: تحويل الدرجات إلى راديان، وتكوين المسافة الزاوية على أنها طول المسار مقسومًا على نصف القطر، وتقييم متطابقات asin وatan2 الكلاسيكية للوجهة، وتطبيع خط الطول ضمن النطاق نصف المفتوح حول مقابل خط الزوال. أما المسافات السالبة وخطوط العرض أو الطول الخارجة عن النطاق فتفشل برسالة invalid_input واضحة بدلًا من اختلاق التفاف صامت. ويشترك widget المجاني في المتصفح وواجهة API المدفوعة في دالة نقية متماثلة واحدة، لذلك لا تتباعد أبدًا العروض الميدانية ومفاتيح الامتحانات والسكربتات الدفعية عند المدخلات نفسها.

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

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

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

طريقة الاستخدام

أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

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

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

ما الصيغة التي تستخدمها حاسبة نقطة الوجهة هذه؟

الصيغة المباشرة الكروية للدائرة العظمى: المسافة الزاوية δ = d/R، وφ2 = asin(sinφ1·cosδ + cosφ1·sinδ·cosθ)، وλ2 = λ1 + atan2(sinθ·sinδ·cosφ1, cosδ − sinφ1·sinφ2)، مع تطبيع خط الطول إلى (−180, 180].

ماذا يحدث إذا كانت المسافة سالبة؟

يفشل الطلب برسالة invalid_input. يجب أن تكون مسافة السفر صفرًا أو موجبة. ويُنمذج السفر العكسي بإضافة 180° إلى الاتجاه، لا بمسافة سالبة.

ما الوحدات التي يمكنني استخدامها للمسافة؟

الأمتار (m، افتراضيًا)، أو الكيلومترات (km)، أو الأميال القانونية (mi)، أو الأميال البحرية (nmi). تُحوَّل القيم إلى أمتار قبل القسمة على نصف قطر الكرة.

هل هذه طريقة Vincenty على الإهليلج WGS84؟

لا. هذا هو النموذج الكروي للدائرة العظمى بمتوسط نصف قطر الأرض 6371000 م (أو earth_radius_m الذي تحدده). وللمساحة عالية الدقة على الإهليلج، استخدم مكتبة جيوديسية مخصصة وصفحة هبوط منفصلة.

كم تبلغ التكلفة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/destination-point

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

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

curl -X POST https://api.kit.forhosting.com/geo/destination-point \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":51.4778,"longitude":-0.0015,"bearing":45,"distance":10000}'

const res = await fetch("https://api.kit.forhosting.com/geo/destination-point", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "latitude": 51.4778,
    "longitude": -0.0015,
    "bearing": 45,
    "distance": 10000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/destination-point",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "latitude": 51.4778,
    "longitude": -0.0015,
    "bearing": 45,
    "distance": 10000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/destination-point", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"latitude":51.4778,"longitude":-0.0015,"bearing":45,"distance":10000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"latitude":51.4778,"longitude":-0.0015,"bearing":45,"distance":10000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/destination-point", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "latitude": 51.4778,
  "longitude": -0.0015,
  "bearing": 45,
  "distance": 10000
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.destination_point",
  "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 الكامل ←

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