ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
التوافق البديل المباشر مع Open-Elevation متاح الآن
ظل Open-Elevation لفترة طويلة وسيلة بسيطة وخالية من التعقيد لإرفاق ارتفاع سطح الأرض بمجموعة من الإحداثيات. ويأخذ مضيفنا المتوافق بنية الطلب والاستجابة نفسها ويضع خلفها خدمة ارتفاع عاملة بالكامل، إلى جانب هيكل حصص يخبرك بدقة بما استخدمته.
يعيد المضيف إنتاج معلمات الطلب في Open-Elevation ومتن الاستجابة مطابقة تامة، باستثناء نصوص حقوق النشر والشروط والخصوصية، التي تخصنا لا المزود الأصلي. أرسل مجموعة من الإحداثيات بالطريقة التي ترسلها بها حاليًا إلى Open-Elevation، وستعود قيم الارتفاع ببنية JSON نفسها التي تحللها شيفرتك الحالية اليوم.
لأن نقطة نهاية الارتفاع لدينا عاملة بالكامل، فهذا ليس مجرد تطابق في البنية. استعلم عن إحداثيات موقع ما وستعيد الاستجابة قيمة ارتفاع حقيقية بالأمتار، بالطريقة نفسها التي يفعلها /v1/elevation مباشرة. وتعمل الطلبات المجمّعة بالطريقة نفسها أيضًا، إذ يُحتسب كل زوج إحداثيات طلبًا واحدًا لا الاستدعاء ككل.
تقبل المصادقة طرقنا الأربع المعتادة: ترويسة X-API-Key، أو ترويسة Authorization: Bearer، أو مصادقة HTTP Basic مع المفتاح بوصفه اسم المستخدم، أو معلمة استعلام. وبما أن Open-Elevation يُستخدم في الغالب دون أي مصادقة على الإطلاق، فإن إضافة مفتاح هنا تعني أيضًا الحصول على حصة مخصصة يمكن تتبعها بدلًا من الاعتماد على مورد مشترك غير مُدار.
تطابق الأسعار كل مضيف آخر على المنصة. يحصل أي عنوان على 2,500 طلب مجاني يوميًا دون الحاجة إلى مفتاح، تُحسب لكل شبكة. ويضيف المفتاح 2,500 طلب مجاني يوميًا خاصة به. وبعد تجاوز الحصتين، يكلّف الرصيد المسبق الدفع 0.0001 € للطلب، أو تغطي باقة Unlimited الاستخدام بسعر 50 € شهريًا.
ترافق ترويسات الحصة كل استجابة: X-Quota-Limit وX-Quota-Used وX-Quota-Free-Remaining وX-Quota-Network-Used وX-Credits-Remaining موجودة كلها، ما يمنح رؤية موثوقة لحجم استعلامات الارتفاع لا توفرها عادة نسخة عامة مشتركة.
لأي شيء يتجاوز استجابة الارتفاع القياسية، يضيف mg_extras=1 في الطلب، أو ترويسة X-MG-Extras، إضافات اختيارية فوق البنية المتوافقة، باختيارك بالكامل.
المضيف موثق في /compatibility/open-elevation/، ونقطة نهاية الارتفاع التي يقوم عليها مشروحة بالكامل في /docs/elevation-lookup/. إذا كانت استعلامات الارتفاع جزءًا من ميزة خرائط أو توجيه لديك اليوم، فهذه طريقة مباشرة لإضافة حصة مخصصة خلف بنية الطلب نفسها.