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