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