ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
التوافق البديل المباشر مع PositionStack متاح الآن
يظهر PositionStack عادة في التكاملات الأخف، وغالبًا في صنف خدمة واحد يغلّف استدعاء API واحدًا داخل تطبيق أكبر. وهذا النوع من التكاملات صغير بما يكفي ليسهل إغفاله، وكبير بما يكفي لتكون إعادة كتابته مزعجة. ومضيفنا المتوافق يهدف إلى إلغاء إعادة الكتابة هذه تمامًا.
يعيد المضيف إنتاج معلمات الطلب في PositionStack ومتن الاستجابة مطابقة تامة، باستثناء نصوص حقوق النشر والشروط والخصوصية، التي تخصنا لا المزود الأصلي. يمكن إرسال الطلب المبني لنقطة نهاية الترميز الجغرافي في PositionStack إلى مضيفنا دون تغيير، وتعود الاستجابة بالبنية نفسها التي تحللها بها الشيفرة الحالية.
ما يتغير هو اسم المضيف والمفتاح. ويصادق هذا المفتاح بأي من طرقنا القياسية الأربع يستخدمها تكاملك أصلًا: ترويسة X-API-Key، أو ترويسة Authorization: Bearer، أو مصادقة HTTP Basic مع المفتاح بوصفه اسم المستخدم، أو معلمة استعلام.
صنف الخدمة الواحد الذي يغلّف استدعاءً واحدًا هو أيضًا نوع التكامل الذي لا يحتفظ له أحد بتوثيق، لذا تميل الأسئلة إلى الظهور على شكل تذاكر دعم ممن ورث الشيفرة لاحقًا. ويحتفظ فريق الدعم في My Geocode بردود جاهزة لهذه الأسئلة المتكررة عن التوافق تحديدًا، مثل معاني الترويسات وصيغ المفاتيح وما يتغير وما لا يتغير، حتى يحصل سؤال الانتقال البسيط على إجابة سريعة بدلًا من الانتظار خلف أسئلة أكثر تعقيدًا.
واختبار بنية الاستجابة قبل المساس بأي شيفرة أمر بسيط أيضًا: يستطيع العرض التفاعلي في /demo/ إرسال طلب نموذجي إلى أي نقطة نهاية أو مضيف توافق وإظهار الحقول الدقيقة العائدة، وهذا يكفي في الغالب للتأكد من أن استدعاءً بصيغة PositionStack سيُحلَّل بسلاسة في المراحل اللاحقة.
لا تختلف الأسعار بحسب مضيف التوافق الذي عالج الطلب. يحصل أي عنوان على 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 وX-Key-IPs-Used وX-Key-IPs-Limit وX-Quota-Reset، ما يوفر رؤية للاستخدام لا يكشفها تكامل PositionStack العادي في غير ذلك.
لأي شيء يتجاوز الحقول القياسية للاستجابة المتوافقة، يضيف mg_extras=1 في الطلب، أو ترويسة X-MG-Extras، إضافات اختيارية فوقها، وهي بالكامل اختيارية التفعيل ومعطلة افتراضيًا.
المضيف موثق في /compatibility/positionstack/، مع نظرة أشمل على طريقة عمل مضيفات التوافق السبعة عشر كلها في /docs/compatibility/. إذا كان PositionStack مخبأً في خدمة ما في منظومتك، فإن توجيهه إلى هنا تغيير صغير يمكن التراجع عنه لاختباره.