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