التحقق من تطابق العنوان مع رمزه البريدي المذكور قبل الدفع
عدم تطابق الرمز البريدي والمدينة في نموذج الطلب يبدو خطأ إملائيًا صغيرًا إلى أن يتحول إلى شحنة مرسلة إلى جزء آخر من البلاد تمامًا.
إنشاء أداة للعثور على المتاجر ترتب النتائج حسب المسافة
معظم أدوات العثور على المتاجر قوائم متنكرة في هيئة خرائط. فالمتسوق يختار ولاية، ثم مدينة، ثم يمرر عبر قائمة أبجدية لا علاقة لها بالموقع الأقرب فعلًا. وقد قررت سلسلة متاجر للأدوات المنزلية تضم عشرات المتاجر أن هذا مقلوب، فأعادت بناء الأداة حول المسافة بدلًا من ذلك.
بدأت إعادة البناء بالمُدخل. فبدلًا من مطالبة المتسوق بالاختيار من قوائم منسدلة، أتاحت الأداة الجديدة له أن يبدأ بكتابة عنوان أو اسم حي وقدمت اقتراحات أثناء الكتابة، باستخدام /v1/autocomplete. تستقبل نقطة النهاية هذه عنوانًا جزئيًا وتعيد تطابقات مرشحة مهيأة لهذا النوع تحديدًا من مربعات البحث المباشر، بحيث يحصل المتسوق الذي يكتب «Oak» على قائمة قصيرة بأسماء شوارع وأماكن حقيقية يختار منها بدلًا من كتابة عنوان كامل على أمل أن يطابق شيئًا في قاعدة بيانات المتاجر.
بمجرد أن يختار المتسوق اقتراحًا أو يسمح للصفحة باستخدام موقعه التقريبي، كانت السلسلة تحتاج إلى شيء واحد آخر: نقطة انطلاق في صورة إحداثيات. فبالنسبة إلى المتسوقين الذين كتبوا عنوانًا، جاءت من الترميز الجغرافي للاقتراح المختار عبر /v1/forward، التي تعيد تطابقًا للموقع مع حقلي خط العرض وخط الطول لعنوان معين. أما المتسوقون الذين لم يكتبوا شيئًا على الإطلاق، فكان الموقع يرجع فيهم إلى /v1/ip، التي تقرأ عنوان IP الخاص بالزائر وتعيد إحداثيات مع المدينة والمنطقة، مما يمنح الأداة نقطة انطلاق معقولة دون طلب أي شيء.
أُجري الترميز الجغرافي لقائمة المتاجر نفسها مرة واحدة، في دفعة واحدة، لأن الطلب المجمّع يحتسب كل عنوان متجر عنصرًا مفوترًا واحدًا. ومع حفظ إحداثيات كل متجر، أصبح الترتيب عملية حسابية: احسب المسافة من نقطة المتسوق إلى كل متجر، ثم رتّب، ثم اعرض أقرب خمسة. لا قوائم منسدلة، ولا تمرير أبجدي، ولا تخمين للبلدة المجاورة التي قد يكون المتجر مدرجًا تحت اسمها.
حافظت السلسلة على صدق الأداة فيما يمكنها أن تعد به. فلأن الترميز الجغرافي الأمامي يعيد تطابقًا لما كُتب لا ضمانًا بأن العنوان موجود تمامًا كما أُدخل، كانت الأداة تقرن القائمة المرتبة دائمًا بخطوة تأكيد، تتيح للمتسوق تعديل نقطة انطلاقه إن لم يكن الموقع المقترح صحيحًا تمامًا. وكان لهذا الفحص الصغير أهمية تفوق أي جزء من منطق الترتيب، لأن نقطة الانطلاق الخاطئة تجعل حتى حساب المسافة المثالي عديم الفائدة.
كانت الزيارات على الأداة متواضعة، بضعة آلاف من الاستعلامات شهريًا للإكمال التلقائي والترميز الجغرافي مجتمعين، وهو ما يقع ضمن الحصة اليومية المجانية المتاحة مع مفتاح My Geocode بفارق كبير. ولم تحتج السلسلة قط إلى التفكير في نموذج التسعير في عملها اليومي، لأن زيارات التجزئة المعتادة على أداة العثور على المتاجر نادرًا ما تقترب من النقطة التي يصبح عندها الرصيد المسبق الدفع أو مفتاح Unlimited الخيار الأفضل، لكن معرفة أن هذا الهامش متاح بسعر 0.0001 € للطلب الواحد كانت تعني أن حملة تسويقية أو إعلان افتتاح متجر لن يعطل أي شيء.
أداة العثور على المتاجر ميزة صغيرة، لكنها كثيرًا ما تكون الخطوة الأخيرة للمتسوق قبل أن يقرر القيادة إلى مكان ما، وضبط الترتيب بشكل صحيح يغير المتجر الذي يحظى بالزيارة. تفاصيل نقطتي النهاية، بما في ذلك أشكال الحقول وحدود معدل الطلبات، متاحة في /docs/address-autocomplete/ و/docs/forward-geocoding/ و/docs/rate-limits/.