راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
تقدير إجمالي الارتفاع المكتسب في مسار
إجمالي الصعود في الارتفاع رقم واحد يخبر المتنزه أو راكب الدراجة عن صعوبة المسار أكثر مما تخبره المسافة وحدها في أي وقت. كما أنه سهل الحساب بمجرد توفر بيانات الارتفاع لعدد كافٍ من النقاط على طول المسار.
الحصول على الارتفاع للمسار
أرسل إحداثيات المسار، بالترتيب، إلى /v1/elevation، إما باستخدام معلمة points أو بوصفها مصفوفة POST مجمّعة.
GET /v1/elevation?points=45.8326,6.8652|45.8400,6.8700|45.8475,6.8750|45.8300,6.8800{
"status": "ok",
"results": [
{"lat": 45.8326, "lon": 6.8652, "elevation_m": 1035},
{"lat": 45.8400, "lon": 6.8700, "elevation_m": 1210},
{"lat": 45.8475, "lon": 6.8750, "elevation_m": 1390},
{"lat": 45.8300, "lon": 6.8800, "elevation_m": 1180}
]
}جمع الصعود
مرّ على النتائج بالترتيب، ولكل زوج متتالٍ أضف الفرق إلى مجموعك التراكمي فقط عندما يزداد الارتفاع. في هذا المثال، الانتقال من 1035 إلى 1210 يضيف 175، ومن 1210 إلى 1390 يضيف 180، ومن 1390 إلى 1180 لا يضيف شيئًا لأن هذا المقطع منحدر نزولًا. إجمالي الصعود في الارتفاع لهذا الامتداد القصير هو 355 متر.
gain = 0
for i in 1..n:
diff = elevation[i] - elevation[i-1]
if diff > 0: gain += diffالنزول في الارتفاع، من البيانات نفسها
الحلقة نفسها، مع عكس المقارنة، تعطيك إجمالي النزول بدلًا من ذلك، وهو لا يقل أهمية عن الصعود في مسار ينتهي أخفض مما بدأ، مثل رحلة من نقطة إلى أخرى نزولًا من جبل.
loss = 0
for i in 1..n:
diff = elevation[i] - elevation[i-1]
if diff < 0: loss += -diffبالنسبة إلى النقاط الأربع أعلاه، إجمالي النزول هو 210 متر، كله من المقطع الأخير المنحدر. وملخص المسار الذي يذكر الصعود فقط ويغفل النزول لا يروي إلا نصف القصة لأي مسار ليس مجرد ذهاب وعودة بسيطين.
المسافة بين النقاط تغيّر الرقم
الصعود في الارتفاع حساس لعدد النقاط التي تأخذ منها العينات. فالنقاط القليلة جدًا تنعّم الصعود والنزول الحقيقيين فينتج إجمالي أقل من الواقع. والنقاط الكثيرة جدًا على مسار GPS مشوش قد تضخّم الرقم بتذبذب صغير صعودًا ونزولًا لم يكن صعودًا حقيقيًا قط. والمسافة بين النقاط كل عشرة إلى ثلاثين مترًا على طول مسار مشي، أو بعد إعادة أخذ العينات على فترات مسافة متساوية، نقطة بداية معقولة.
خطأ يستحق التجنب
تشغيل حساب الصعود مباشرة على مسار GPS خام دون إعادة أخذ العينات أولًا طريقة شائعة للخروج برقم متضخم، لأن مسارات GPS الاستهلاكية كثيرًا ما تتذبذب صعودًا ونزولًا ببضعة أمتار بين النقاط المسجلة المتتالية حتى على أرض مستوية فعلًا. أعد أخذ عينات المسار على فترات مسافة متساوية قبل أن تطلب الارتفاع له، بدلًا من طلب الارتفاع لكل نقطة خام سجلها الجهاز.
تكلفة الطلبات
كل نقطة طلب واحد، سواء أُرسلت عبر معلمة points أو في مصفوفة مجمّعة. فالمسار الذي يضم 300 نقطة من العينات يكلّف 300 طلب، وهي لا تزال حصة صغيرة من 2,500 طلب مجاني يوميًا المضمّنة مع كل مفتاح.
الصعود في الارتفاع المحسوب بهذه الطريقة جيد بقدر جودة أخذ عينات النقاط التي يقوم عليها فقط، لذا من المفيد اختبار خيارين أو ثلاثة للمسافة بين النقاط على مسار معروف قبل الاستقرار على أحدها. خيارات الطلب الكاملة موجودة في صفحة توثيق الاستعلام عن الارتفاع.