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