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