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