التحقق من تطابق العنوان مع رمزه البريدي المذكور قبل الدفع
عدم تطابق الرمز البريدي والمدينة في نموذج الطلب يبدو خطأ إملائيًا صغيرًا إلى أن يتحول إلى شحنة مرسلة إلى جزء آخر من البلاد تمامًا.
رسم مناطق التوصيل حول مستودع
افتتحت سلسلة بقالة إقليمية مستودعًا ثانيًا واحتاجت إلى إجابة عن سؤال بسيط قبل أن تتمكن من الوعد بالتوصيل في اليوم نفسه: أي العملاء يمكن الوصول إليهم فعلًا من المبنى الجديد خلال مدة قيادة معقولة، وأيهم لا يزال الموقع الأصلي يخدمه بشكل أفضل.
كانت المحاولة الأولى رسم هذا الخط يدويًا، ببيكار وتخمين لمسافة الطريق، فأنتجت منطقة توصيل بدت معقولة وأدّت أداءً سيئًا. فبعض العناوين داخل الدائرة كانت على بعد أربعين دقيقة عبر الطريق الوحيد الذي يصل إليها. وبعضها الآخر خارجها بقليل كان أقرب مما توحي به الخريطة.
يبدأ النهج الأفضل بتحويل العناوين إلى إحداثيات. يأخذ استدعاء /v1/forward عنوانًا ويعيد نتيجة مطابقة تتضمن حقلي خط العرض وخط الطول، وهو نوع الموقع المنظم الذي يحتاجه حساب المسافة بدلًا من اسم شارع يضطر أداة التوجيه إلى تخمينه. يُرمَّز عنوان المستودع جغرافيًا مرة واحدة. ويُرمَّز كل عنوان طلب في قائمة العملاء في الدفعة نفسها، لأن الطلب المجمّع يحسب كل عنوان عنصرًا واحدًا مفوترًا بدلًا من الاحتساب لكل استدعاء.
مع توفر الإحداثيات على الطرفين، تصبح المسافة المستقيمة من المستودع إلى كل عميل عملية حسابية بسيطة يستطيع نظام سلسلة البقالة نفسه إجراؤها. لم تعد المناطق دائرة مرسومة باليد، بل أصبحت حدودًا مبنية على المواقع الفعلية التي تُخدم، وتُحدَّث تلقائيًا كلما وصل عنوان عميل جديد. وعندما احتاج النطاق الفعلي للمستودع إلى التقلص لأن مواعيد التوصيل بدأت تتأخر، أمكن إعادة رسم الحدود من البيانات نفسها بدلًا من إعادة رسمها بالعين.
وكان للاتجاه المعاكس أهميته أيضًا. ففي بعض الأحيان لم يكن لدى خدمة العملاء سوى مجموعة إحداثيات من تطبيق توصيل، دون عنوان شارع واضح، واحتاجت إلى معرفة المنطقة والمتجر اللذين تتبعهما تلك النقطة. يأخذ /v1/reverse زوج إحداثيات ويعيد مكونات العنوان لذلك الموقع، فيحوّل الدبوس على الخريطة من جديد إلى شيء يمكن لجدول توجيه المستودع استخدامه.
لم يتطلب أي من ذلك أن تبني سلسلة البقالة منصة خرائط أو تشتري ترخيصًا لها. كانت خطوة الترميز الجغرافي هي القطعة الوحيدة الناقصة، واندمجت في برنامج اللوجستيات الذي كانت الشركة تشغّله داخليًا بالفعل. أُعيد الترميز الجغرافي لبضعة آلاف من العناوين عند افتتاح المستودع الجديد، مع تدفق أصغر من الطلبات الجديدة يُرمَّز يوميًا بعد ذلك، ضمن الحصة المجانية اليومية التي تستخدمها معظم العمليات بهذا الحجم بفارق مريح، مع متسع للنمو نحو الرصيد المسبق الدفع إذا ارتفع حجم الطلبات.
والدرس ينطبق على ما هو أبعد من توصيل البقالة. فأي نشاط تجاري يرسم حدود خدمة حول موقع مادي، سواء كان مستودعًا أو مركز صيانة أو فريق تركيب في اليوم نفسه، يحتاج إلى الأمرين نفسيهما: طريقة موثوقة لتحويل العنوان إلى إحداثيات، وطريقة موثوقة لتحويل الإحداثيات إلى عنوان عندما تصل البيانات من الاتجاه الآخر. وكلاهما يأتي من المفتاح نفسه.
صيغ الطلب والاستجابة لنقطتي النهاية موثقة في /docs/forward-geocoding/ و/docs/reverse-geocoding/.