ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
إضافة اقتراحات الإكمال التلقائي عبر المضيفات المتوافقة
الإكمال التلقائي للعناوين نوع مختلف من الطلبات عن استعلام الترميز الجغرافي المباشر: فهو يحتاج إلى الاستجابة لمدخلات جزئية متغيرة بدلًا من عنوان واحد مكتمل، وعادة ما يكون ذلك أثناء كتابة شخص ما في نموذج. وقد وسّعنا مضيفاتنا المتوافقة لتدعم هذا النمط أيضًا، بما يطابق صيغة طلب الإكمال التلقائي لدى المزوّدين الذين يقدمونه.
يأتي هذا إلى جانب نقطة النهاية الأصلية لدينا /v1/autocomplete، الموثقة في /docs/address-autocomplete/، التي تعالج النوع نفسه من طلبات العناوين الجزئية مباشرة. وحيثما كان المزوّد الأصلي لمضيف متوافق يقدم الإكمال التلقائي أيضًا، أصبحت صيغة الطلب نفسها مدعومة الآن على المضيف المكافئ لدينا، باستثناء نصوص حقوق النشر والشروط والخصوصية، فهي نصوصنا.
تتبع المصادقة والتسعير لطلبات الإكمال التلقائي القواعد نفسها تمامًا التي تنطبق على كل أنواع الطلبات الأخرى في المنصة. فالمفتاح يُصادَق عليه كترويسة X-API-Key، أو ترويسة Authorization: Bearer، أو مصادقة HTTP Basic، أو معامل استعلام، ويُحتسب الاستخدام من الحصة اليومية المجانية نفسها، سواء جاءت تلك الحصة من الشبكة المستدعية أو من المفتاح نفسه. وبعد تجاوز الحصة المجانية، تُخصم طلبات الإكمال التلقائي من الرصيد المسبق الدفع بسعر 0.0001 € للطلب أو تغطيها باقة Unlimited، تمامًا مثل أي نقطة نهاية أخرى.
تميل حركة الإكمال التلقائي إلى السير بوتيرة مختلفة عن استعلام الترميز الجغرافي المعتاد، إذ كثيرًا ما تُطلق مع كل ضغطة مفتاح أثناء كتابة شخص ما عنوانًا في نموذج بدلًا من مرة واحدة لكل إرسال مكتمل. وهذا يجعل رؤية الحصة مفيدة بشكل خاص هنا: فترويسات الحصة نفسها المرفقة بكل استجابة، X-Quota-Limit وX-Quota-Used وX-Quota-Free-Remaining وغيرها، تتيح للتكامل مراقبة الاستهلاك في الوقت الفعلي وتعديل سلوكه، مثل تأخير الطلبات بشكل أشد، إذا كان الاستخدام أعلى من المتوقع.
بالنسبة للفرق التي تستخدم أصلًا مضيفًا متوافقًا للترميز الجغرافي وتتعامل بشكل منفصل مع الإكمال التلقائي عبر مزوّد آخر أو تكامل ثانٍ، يعني هذا التحديث أن الإكمال التلقائي يمكن الآن أن ينتقل إلى المضيف نفسه والمفتاح نفسه، بما يجمع نوعي الطلبات تحت حساب واحد بدلًا من توزيعهما على حسابين.
تعتمد المضيفات المتوافقة التي تدعم الإكمال التلقائي على ما إذا كان مزوّدها الأصلي يدعمه، والتفاصيل الخاصة بكل منها موثقة في الصفحة الخاصة بذلك المضيف، ويمكن الوصول إليها من القائمة الكاملة في /compatibility/. وتجربة الإكمال التلقائي على مضيف متوافق لا تكلف شيئًا، نظرًا للحصة المجانية المتاحة لأي مفتاح جديد.