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

التغير الصافي للارتفاع

لمقطع ارتفاعاته 100 و120 و110 و150 و140 مترًا يكون التغير الصافي 40 مترًا، لكن المسار يصعد 60 مترًا إجمالًا وينزل 20 مترًا. وتحصل أيضًا على أدنى نقطة وأعلاها والمدى ومجموع الحركة الرأسية. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

المناسيب: 100, 120, 110, 150, 140 m

تحصل على

عدد العينات: 5 m
المنسوب الابتدائي: 100
المنسوب النهائي: 140
أدنى منسوب: 100

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

معنى التغير الصافي والكسب الكلي والخسارة الكلية على ملف الارتفاع

عند عيّنات ارتفاع مرتبة e0, e1, …, e(n−1) على طول مسار، يكون التغير الصافي للارتفاع ببساطة القيمة الأخيرة ناقص الأولى: النهاية ناقص البداية. يجيب هذا الرقم الوحيد عما إذا انتهى المسار أعلى أم أدنى مما بدأ، ويكون سالبًا عندما يكون المقصد تحت نقطة الأصل. وهو لا يصف صعوبة المسار المحسوسة.

يجمع الكسب الكلي كل فرق متتالٍ موجب max(0, ei − e(i−1))، فيساهم كل مقطع صعود في الصعود التراكمي حتى لو فقدت الارتفاع نفسه لاحقًا. وتجمع الخسارة الكلية كل خطوة هبوط كـ max(0, e(i−1) − ei). جبريًا يساوي التغير الصافي الكسب الكلي ناقص الخسارة الكلية (ضمن تقريب الفاصلة العائمة)، وهذا فحص سلامة مفيد عند مراجعة مستخرجات GPX أو DEM.

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

نقِّ السلاسل البارومترية الصاخبة في المنبع إذا احتجت إحصاءات مسار ممهَّدة لقواعد السباق أو نماذج حمل التدريب.

من يحتاج أرقام صعود موثوقة

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

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

أبقِ السلاسل قصيرة بما يكفي للواجهات التفاعلية، وثبّت ملفات ذهبية في الاختبارات، لتحصل على إحصاءات صعود حتمية لأدوات المشي ومختبرات جغرافيا LMS والعُقد الطرفية دون بناء مكدس جغرافي كامل خاص بك.

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

تسميات صعوبة مسارات المشي

زوّد عيّنات DEM أو بارومتر مرتبة من مسار GPX وانشر التغير الصافي والكسب الكلي والخسارة الكلية على بطاقات المسارات للمتنزّهين الذين يختارون بين الحلقات.

خرائط المسارات والفعاليات

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

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

كيف يُحسب التغير الصافي للارتفاع؟

التغير الصافي هو آخر عيّنة ارتفاع ناقص الأولى. يجمع الكسب الكلي الخطوات المتتالية الموجبة؛ وتجمع الخسارة الكلية الخطوات السالبة بالقيمة المطلقة. المتطابقة: net = gain − loss.

لماذا يكون الكسب الكلي أكبر من التغير الصافي؟

لأن الصعودات الوسيطة تُحسب حتى إذا نزلت لاحقًا. الذهاب والعودة الذي يعود إلى البداية له صافٍ صفر لكن كسبًا كليًا موجبًا يساوي الخسارة الكلية.

هل أحتاج مسافة أو إحداثيات GPS؟

لا. تُطلب فقط عيّنات ارتفاع مرتبة. المسافة والميل والإسقاط الخرائطي خارج النطاق؛ احسبها منفصلة عند الحاجة.

هل يحوّل الحقل unit الأمتار إلى أقدام؟

لا. unit تسمية عرض (m أو ft). أرسل الملف كاملًا في نظام وحدات واحد؛ لا يحوّل المعالج القيم.

هل تُنعَّم قراءات GPS أو مقياس الضغط المشوشة؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/net-elevation-change

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

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

curl -X POST https://api.kit.forhosting.com/geo/net-elevation-change \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"elevations":[100,120,110,150,140]}'

const res = await fetch("https://api.kit.forhosting.com/geo/net-elevation-change", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "elevations": [
      100,
      120,
      110,
      150,
      140
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/net-elevation-change",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "elevations": [
        100,
        120,
        110,
        150,
        140
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/net-elevation-change", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"elevations":[100,120,110,150,140]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"elevations":[100,120,110,150,140]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/net-elevation-change", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "elevations": [
    100,
    120,
    110,
    150,
    140
  ]
}

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

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

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

تشترك أداة المتصفح المجانية وواجهة API المدفوعة في الوحدة نفسها، فلا تختلف دفاتر الملاحظات وخطط التدريب والعُقد الطرفية حول ملف واحد.

عقد الإدخال والوحدات وحقول الاستجابة والتحقق

الوحدة الاختيارية unit تعداد لـ m أو ft (الافتراضي m) وهي تسمية فقط—لا يحوّل المعالج بين المتر والقدم، فحافظ على السلسلة كلها في نظام واحد. أقل من عيّنتين يفشل لأن ارتفاعًا واحدًا لا يعرّف تغيّرًا. تُقرَّب الحقول العددية إلى اثنتي عشرة منزلة عشرية لثبات الأمثلة الذهبية عبر محركات JavaScript. اقرن الأرقام بحسابات المسافة والميل الخاصة بك إن احتجت نسبة الانحدار؛ يقيس هذا الطرف فقط الفروق الرأسية بين عيّنات متتالية. أرسل جسم JSON يتضمن elevations، وهو مصفوفة إلزامية من عددين نهائيين على الأقل بترتيب المسار. تُقبل الأسماء البديلة samples وprofile وvalues وheights وتُحلّ بالطريقة نفسها. قد يكون كل عنصر عدد JSON أو سلسلة رقمية؛ القيم غير النهائية والخانات الفارغة والرموز غير الرقمية تفشل بـ invalid_input مع تسمية الفهرس الخاطئ. عند النجاح يتضمن الجسم sample_count؛ start_elevation وend_elevation؛ min_elevation وmax_elevation وelevation_range؛ net_change؛ total_gain وtotal_loss؛ total_vertical؛ الوحدة المُعادة؛ وسلسلة صيغة قصيرة تعيد ذكر المتطابقات. مثال: elevations [100, 120, 110, 150, 140] تعطي بداية 100 ونهاية 140 وnet_change 40 وtotal_gain 60 (20+40) وtotal_loss 20 (10+10) وحد أدنى 100 وحد أقصى 150 ونطاق 50 وtotal_vertical 80.

أين تُثبت واجهة API للتغير الصافي للارتفاع قيمتها

ولأن التنفيذ parse خالص من المستوى A، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج وبلا شبكة صادرة.

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

أتمتة GIS ودفاتر الملاحظات

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

أسئلة تقنية

كم تكلفة حاسبة التغير الصافي للارتفاع؟

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

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

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