راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
إنشاء مخطط ارتفاعات لمسار مشي أو ركوب دراجات
مخطط الارتفاعات ليس سوى قائمة من النقاط مع ارتفاع مرتبط بكل منها، مرسومة مقابل المسافة على طول المسار. وتمنحكم نقطة نهاية الارتفاع ذلك الارتفاع لكل النقاط التي ترسلونها إليها، في استدعاء واحد.
إرسال المسار
مرروا سلسلة من أزواج خطوط العرض والطول عبر المعامل points، مفصولة بخطوط عمودية (|)، مع فصل قيمتي كل زوج بفاصلة.
GET /v1/elevation?points=45.8326,6.8652|45.8400,6.8700|45.8475,6.8750{
"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}
]
}تحويل النتائج إلى مخطط
يتوافق كل عنصر في results مع النقطة التي أرسلتموها في الموضع نفسه. اقرنوا elevation_m بالمسافة التراكمية بين النقاط المتتالية، التي تحسبونها بأنفسكم من الإحداثيات، فتحصلون على قيم المحورين x وy لمخطط الارتفاعات دون أي استعلامات إضافية.
مثال أقصر باستخدام جسم طلب مجمّع
إذا كنتم تفضلون إرسال مصفوفة منظمة بدلًا من المعامل points المفصول بخطوط عمودية، فأرسلوا عبر POST مصفوفة JSON من كائنات الإحداثيات إلى /v1/elevation بالطريقة نفسها التي تقبل بها نقاط النهاية الأخرى الأجسام المجمّعة.
POST /v1/elevation
Content-Type: application/json
[{"lat": 45.8326, "lon": 6.8652}, {"lat": 45.8400, "lon": 6.8700}]في الحالتين التكلفة واحدة، طلب واحد لكل نقطة، لذا اختاروا الشكل الأسهل بناءً من بنية البيانات المتوفرة لديكم أصلًا، سواء كانت سلسلة استعلام مبنية من مصفوفة أو مصفوفة JSON مبنية بالطريقة نفسها.
اختيار المسافة بين النقاط
لا يحتاج مسار يضم مئة نقطة GPS كل بضعة أمتار إلى ارتفاع كل نقطة منها لرسم مخطط مقروء. فأخذ عينة كل عشرين أو خمسين نقطة على طول مسار طويل، أو إعادة أخذ العينات على فواصل مسافة متساوية، يحافظ على سلاسة المخطط مع تقليل عدد الطلبات، لأن كل نقطة في المعامل points تُحتسب طلبًا واحدًا.
خطأ يستحق التجنب
معاملة elevation_m على أنها دقيقة حتى السنتيمتر تطلب من البيانات أكثر مما يحتاجه مخطط الارتفاعات. فالقيمة دقيقة بما يكفي لرسم مخطط سلس ومقروء ولحساب إجمالي صعود معقول، لكن نقطتين تفصل بينهما مسافة متر واحد على أرض مستوية قد تعيدان قراءتين مختلفتين قليلًا لا تعنيان شيئًا عن التضاريس الفعلية. صمموا مخططكم وحسابات الصعود لديكم بحيث تتحمل هذا النوع من التشويش الطفيف بدلًا من معاملة كل تذبذب على أنه سمة حقيقية للمسار.
حالة حدّية فوق المياه أو في تضاريس غير مرسومة
قد تعيد نقطة تقع فوق مياه مفتوحة أو في منطقة قليلة بيانات الارتفاع قيمة منخفضة أو مستوية بدلًا من خطأ. وإذا كان مساركم يتضمن عبورًا بعبّارة أو جزءًا يمر عبر تضاريس نائية، فتحققوا من الأجزاء المستوية على نحو غير معتاد في مخططكم بمقارنتها بالخريطة نفسها بدلًا من افتراض أن الرقم يصف دائمًا أرضًا صلبة.
كم يكلف
مخطط من مئة نقطة يعني مئة طلب، وهو ضمن حدود 2,500 طلب مجاني يوميًا المتاحة مع كل مفتاح، أو من عنوان واحد دون مفتاح، بفارق كبير. ومع ذلك ينبغي لأداة تخطيط مسارات تخدم مستخدمين كثيرين يوميًا أن تراقب ترويسات الحصة، لأن مخططات الارتفاع للمسارات الشائعة تتراكم أسرع من الاستعلامات الفردية.
تحوّل بيانات الارتفاع الخريطة المسطحة إلى شيء يستطيع المتنزه أو راكب الدراجة أن يخطط على أساسه فعلًا. وتجدون قائمة المعاملات كاملة في صفحة توثيق الاستعلام عن الارتفاع.