راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
أضف الملء التلقائي للرمز البريدي إلى نموذج الشحن
نموذج الشحن الذي يحتوي على حقول منفصلة للرمز البريدي والمدينة والمنطقة يطلب من العميل كتابة معلومات كثيرًا ما يدل عليها الرمز البريدي وحده.
الاستعلام عن الرمز
بمجرد أن ينتهي العميل من كتابة الرمز البريدي ويختار الدولة، أو إذا كانت الدولة معروفة مسبقًا من حسابه، أرسل كليهما إلى /v1/postcode.
GET /v1/postcode?code=SW1A 1AA&country=GB{
"status": "ok",
"postcode": "SW1A 1AA",
"country_code": "GB",
"results": [
{"lat": 51.5014, "lon": -0.1419, "components": {"city": "London", "region": "Greater London", "country": "GB"}}
]
}ملء حقول النموذج
املأ حقلي المدينة والمنطقة مباشرة من الكائن components في النتيجة، ودع العميل يؤكدهما أو يصححهما بدلًا من قفل الحقلين تمامًا، لأن الرمز البريدي قد يمتد أحيانًا عبر حدود إدارية أو يغطي أكثر من اسم مكان شائع الاستخدام.
مثال ثانٍ: ملء منطقة الفوترة مسبقًا لأغراض الضرائب
يناسب الاستعلام نفسه نموذج تسجيل أو فوترة يحتاج إلى منطقة العميل لأغراض حساب الضرائب، لا نموذج الشحن فقط. وإطلاق استعلام الرمز البريدي نفسه بمجرد إدخال الرمز البريدي للفوترة يملأ حقل المنطقة بشكل متسق في كلا السياقين باستخدام شكل الطلب والاستجابة المتطابق نفسه، بحيث يمكن لشيفرة المعالجة نفسها من جهة العميل ومن جهة الخادم أن تخدم النموذجين.
إطلاق الاستعلام في اللحظة المناسبة
شغّل الاستعلام عندما يفقد حقل الرمز البريدي التركيز، أو عندما يبلغ الطول المتوقع للدولة المختارة، بدلًا من تشغيله مع كل ضغطة مفتاح، لأن الرمز البريدي لا يكون ذا معنى للاستعلام عنه إلا بعد اكتماله. وهذا يُبقي الميزة عند طلب واحد لكل إدخال مكتمل للحقل بدلًا من طلب لكل حرف مكتوب.
خطأ شائع يجب تجنبه
لا تثبّت في الشيفرة طولًا متوقعًا واحدًا لصيغة الرمز البريدي في كل الدول. فافتراض خمسة أرقام الذي ينجح في دولة ما سيطلق الاستعلام مبكرًا جدًا أو لن يطلقه أبدًا في دولة تستخدم طولًا مختلفًا أو صيغة أبجدية رقمية مثل المثال أعلاه. إما أن تطلقه عند فقدان التركيز بغض النظر عن الطول، أو أن تحتفظ بجدول صغير للأطوال حسب الدولة إذا أردت الإطلاق مبكرًا للدول التي تدعمها أكثر من غيرها.
التعامل مع رمز غير معروف
مصفوفة النتائج الفارغة تعني أن الرمز لم يُتعرَّف عليه لتلك الدولة، وغالبًا بسبب خطأ إملائي. اترك حقلي المدينة والمنطقة فارغين ودع العميل يملؤهما يدويًا بدلًا من منع إرسال النموذج، لأن رفض الحقل كليًا بسبب فشل الملء التلقائي تجربة أسوأ من مجرد طلب الإدخال اليدوي في تلك الحالة الوحيدة.
حالة حدّية: رمز يغطي أكثر من اسم مكان
بعض الرموز البريدية تغطي بشكل مشروع منطقة معروفة محليًا بأكثر من اسم، أو تقع تمامًا على الحد بين اسمي مدينتين شائعي الاستخدام. عندما يحدث هذا، فإن عرض القيمة المعادة كاقتراح قابل للتعديل بدلًا من تسمية ثابتة يتيح للعميل تصحيحها إلى الاسم الذي يستخدمه فعلًا، دون اعتبار أي منهما أكثر أو أقل رسمية من الآخر.
الحصول على إحداثيات دقيقة بعد اكتمال العنوان
الملء التلقائي من الرمز البريدي يعطي موقعًا على مستوى المنطقة، وهو ما يكفي لحقلي المدينة والمنطقة، لكن بمجرد أن يكتب العميل عنوان شارع كاملًا فوق ذلك، فإن تمرير العنوان الكامل عبر /v1/forward يمنحك الإحداثيات الدقيقة التي يحتاجها فعلًا ملصق الشحن أو نظام توجيه التوصيل.
كم يكلف
كل حقل رمز بريدي مكتمل يطلق طلبًا واحدًا. ونموذج الشحن الذي يعالج طلبات شراء كثيرة يوميًا يستخدم هذه الميزة بمعدل متواضع، استعلام واحد لكل طلب شراء بدلًا من كل ضغطة مفتاح، مما يُبقيها ضمن 2,500 طلب مجاني يوميًا المضمنة مع كل مفتاح بفارق كبير لمعظم المتاجر.
الملء التلقائي للمدينة والمنطقة من الرمز البريدي يختصر نموذج الشحن بحقلين للغالبية العظمى من العملاء الذين يكتبون رمزًا صحيحًا. تعريفات الحقول الكاملة موجودة في توثيق الاستعلام عن الرمز البريدي.