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