ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
التوافق البديل المباشر مع Geoapify متاح الآن
يجمع Geoapify بين الترميز الجغرافي ومجموعة أوسع من أدوات الموقع، ما يعني أن التكاملات المبنية عليه تمس أحيانًا جزءًا من قاعدة الشيفرة أكبر مما يوحي به استدعاء API واحد. يركز مضيفنا المتوافق تركيزًا ضيقًا على بنية طلب الترميز الجغرافي واستجابته، مطابقة تمامًا، كي ينتقل هذا الجزء دون الإخلال بكل ما حوله.
يعيد المضيف إنتاج معلمات الطلب في Geoapify ومتن الاستجابة بدقة، باستثناء نصوص حقوق النشر والشروط والخصوصية، التي تخصنا لا المزود الأصلي. يمكن إرسال الطلب المبني حاليًا لنقاط نهاية الترميز الجغرافي في Geoapify إلى مضيفنا كما هو، ويُحلَّل JSON العائد بالطريقة نفسها التي تتوقعها الشيفرة الحالية.
تضييق النطاق بهذه الطريقة مقصود. فمنصة Geoapify نفسها تغطي التوجيه وخطوط تساوي الزمن والبحث عن الأماكن إلى جانب الترميز الجغرافي، ومحاولة مطابقة كل ذلك داخل مضيف توافق واحد كانت ستربط جدول إصداراته بميزات بعيدة كل البعد عن الترميز الجغرافي نفسه. وقصر المضيف على نقاط نهاية الترميز الجغرافي يجعل التحقق منه مقابل الخدمة الأصلية بسيطًا ويسهّل إبقاءه متسقًا بينما يضيف My Geocode قدرات خاصة به.
يعني الانتقال تغيير اسم المضيف والمفتاح، لا أكثر. ويصادق هذا المفتاح بالطريقة المرنة نفسها المتبعة على كل مضيف نشغّله: في ترويسة X-API-Key، أو في ترويسة Authorization: Bearer، أو عبر مصادقة HTTP Basic مع المفتاح بوصفه اسم المستخدم، أو في معلمة استعلام. وأيًا كانت الطريقة التي يرسلها عميلك الحالي، فهي مقبولة هنا أيضًا.
الأسعار التي يقوم عليها ذلك لم تتغير عن بقية المنصة. يحصل أي عنوان على 2,500 طلب مجاني يوميًا دون أي مفتاح، تُحسب لكل شبكة. ويضيف المفتاح 2,500 طلب مجاني يوميًا خاصة به فوق ذلك. وبعد تجاوز الحصتين، يكلّف الرصيد المسبق الدفع 0.0001 € للطلب، أو تغطي باقة Unlimited كل شيء بسعر 50 € شهريًا، مع تطبيق السعر نفسه سواء ذهب الاستدعاء إلى هذا المضيف أو إلى /v1/forward مباشرة.
ترافق ترويسات الحصة كل استجابة هنا أيضًا: تظهر جميعها 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، ما يمنح رؤية لا يوفرها تكامل Geoapify المباشر من تلقاء نفسه.
كما أن نقل تكامل الترميز الجغرافي إلى مزود جديد لحظة مناسبة لتشديد أمان الحساب عمومًا. فإعداد المصادقة الثنائية في لوحة التحكم يقع إلى جانب مفاتيح API والفوترة، لذا فإن تفعيله لحساب يحمل الآن مفتاحًا جديدًا يستغرق خطوة إضافية واحدة بدلًا من مشروع مستقل قائم بذاته.
لأي شيء يتجاوز الاستجابة المتوافقة القياسية، تضيف إضافة mg_extras=1 إلى الطلب، أو ترويسة X-MG-Extras، حقولًا اختيارية فوقها دون تغيير البنية الأساسية ما لم يُطلب ذلك صراحة.
يتوفر التوثيق الكامل للمضيف في /compatibility/geoapify/، ومرجع التوافق الأشمل الذي يغطي المضيفات السبعة عشر كلها في /docs/compatibility/. إذا كان Geoapify يعمل بالفعل خلف جزء من منظومتك، فهذه طريقة قليلة الجهد لمقارنته بخدمتنا.