استخدام واجهة برمجة تطبيقات التحقق من العنوان لمعالجة العناوين بحجم كبير

الهدف

وبصفتك مطورًا، فإنك غالبًا ما تتعامل مع مجموعات بيانات تحتوي على عناوين عملاء قد لا تكون ذات جودة جيدة. يجب التأكد من صحة العناوين من التحقق من هوية العميل إلى التسليم وغير ذلك.

عملية التحقق من العنوان API هي منتج من "منصة خرائط Google" التي يمكنك استخدامها للتحقق من صحة أحد العناوين. ومع ذلك، يعالج عنوان واحد في كل مرة. في هذا المستند، سننظر في كيفية استخدام عملية التحقّق من صحة العناوين ذات الحجم الكبير في ظل سيناريوهات مختلفة، من اختبار واجهة برمجة التطبيقات إلى التحقق من العنوان لمرة واحدة بشكل متكرر.

حالات الاستخدام

سوف نفهم الآن حالات الاستخدام التي تكون فيها التحقق من العنوان بكميات كبيرة هو مفيدة.

الاختبار

ترغب غالبًا في اختبار واجهة برمجة تطبيقات التحقق من صحة العنوان عن طريق تشغيل آلاف من . قد يكون لديك العناوين في ملف قيم مفصولة بفواصل وتريد للتحقق من جودة العناوين.

إثبات صحة العناوين لمرة واحدة

أثناء الانضمام إلى واجهة برمجة تطبيقات التحقق من صحة العناوين، تحتاج إلى التحقق من قاعدة بيانات العناوين الحالية مقابل قاعدة بيانات المستخدم.

إثبات صحة العناوين بشكل متكرّر

يطلب عدد من السيناريوهات التحقق من العناوين على أساس متكرر:

• قد تكون لديك مهام مُجدوَلة للتحقّق من صحة العناوين للحصول على التفاصيل. خلال اليوم، على سبيل المثال، من اشتراكات العملاء، وتفاصيل الطلب، والتسليم الجداول الزمنية.
• قد تتلقى نُسخ بيانات تحتوي على عناوين من أقسام مختلفة على سبيل المثال، بدءًا من المبيعات إلى التسويق. إن القسم الجديد الذي يتلقى العناوين في كثير من الأحيان التحقق من صحتها قبل استخدامها.
• يمكنك جمع العناوين أثناء الاستبيانات أو العروض الترويجية المختلفة ولاحقًا عند التحديث في النظام عبر الإنترنت. تريد التحقّق من أنّ العناوين صحيح أثناء إدخالها في النظام.

نظرة معمّقة على الجوانب الفنية

لأغراض هذا المستند، نفترض أن:

• أنت تستدعي واجهة برمجة تطبيقات التحقق من صحة العنوان باستخدام عناوين من عميل قاعدة بيانات (أي قاعدة بيانات تحتوي على تفاصيل العملاء)
• يمكنك تخزين علامات الصلاحية مؤقتًا في مقابل العناوين الفردية في قاعدة البيانات الخاصة بك.
• يتم استرداد علامات الصلاحية من واجهة برمجة تطبيقات التحقق من صحة العنوان عند تسجيل دخول كل عميل.

ذاكرة التخزين المؤقت للاستخدام في قناة الإصدار العلني

عند استخدام واجهة برمجة تطبيقات التحقق من صحة العنوان، فإنك غالبًا ما تحتاج إلى تخزين جزء من ذاكرة التخزين المؤقت استجابة من استدعاء واجهة برمجة التطبيقات. وعلى الرغم من أن بنود حد الخدمة والبيانات التي يمكن تخزينها مؤقتًا، وأي بيانات يمكن تخزينها مؤقتًا من واجهة برمجة تطبيقات التحقق من صحة العناوين أن يتم تخزينها مؤقتًا في حساب مستخدم. وهذا يعني أنه في قاعدة البيانات، العنوان أو العنوان في ذاكرة التخزين المؤقت على عنوان البريد الإلكتروني للمستخدم أو بمعرف أساسي آخر.

بالنسبة إلى حالة استخدام "التحقق من العناوين ذات الكميات الكبيرة"، يجب أن يتبع التخزين المؤقت للبيانات واجهة برمجة تطبيقات التحقق من صحة العناوين المتعلقة بخدمة بنود الخدمة الموضحة في الفقرة 11.3. بناءً على هذه المعلومات، ستتمكن من لتحديد ما إذا كان عنوان المستخدم غير صالح أم لا، وفي هذه الحالة ستطلب المستخدم للحصول على عنوان تم تصحيحه أثناء تفاعله التالي مع التطبيق.

• البيانات من AddressComponent كائن
  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

إذا كنت تريد تخزين أي معلومات عن العنوان الفعلي في ذاكرة التخزين المؤقت، أن يتم تخزينها مؤقتًا بموافقة المستخدم فقط. يضمن ذلك أن يكون المستخدم سبب تخزين خدمة معينة لعنوانها، ويوافق على مشاركة عناوينهم.

من الأمثلة على موافقة المستخدم التفاعل المباشر مع عنوان للتجارة الإلكترونية على صفحة الدفع. هناك فهم أنك ستقوم بالتخزين المؤقت معالجة العنوان لأغراض شحن الطرد.

بعد الحصول على موافقة المستخدم، يمكنك تخزين "formattedAddress" ومكوّنات رئيسية أخرى في ذاكرة التخزين المؤقت. من الرد. ومع ذلك، في سيناريو بلا واجهة مستخدم رسومية، لا يمكن للمستخدم تقديم الموافقة نظرًا لأن التحقق من العنوان يتم من الخلفية. ولذلك، يمكنك تخزين معلومات محدودة للغاية في ذاكرة التخزين المؤقت في هذا السيناريو بلا واجهة مستخدم رسومية.

فهم الردّ

إذا كان رد واجهة برمجة التطبيقات للتحقق من صحة العنوان يحتوي على العلامات التالية، فينبغي لك أن تكون واثقًا من جودة عنوان الإدخال:

• علامة addressComplete في الحكم الكائن هو true،
• validationGranularity في الحكم الكائن PREMISE أو SUB_PREMISE
• لا شيء من AddressComponent تحمل العلامة التالية:
  • Inferred(ملاحظة: inferred=trueيمكن أن يحدث ذلك عندما addressComplete=true)
  • spellCorrected
  • replaced
  • unexpected،
• confirmationLevel: مستوى التأكيد في AddressComponent تم ضبطها علىCONFIRMEDأوUNCONFIRMED_BUT_PLAUSIBLE

في حال لم تتضمّن استجابة واجهة برمجة التطبيقات العلامات أعلاه، حينئذٍ سيتم إدخال عنوان الإدخال. كانت على الأرجح ذات جودة رديئة، ويمكنك تخزين العلامات في قاعدة البيانات مؤقتًا لتعكس ذلك. تشير العلامات المخزّنة مؤقتًا إلى أن العنوان ككل رديئة، بينما تشير علامات أكثر تفصيلاً مثل "تصحيح إملائي" إلى النوع المحدد من مشكلة الجودة في التعامل. عند تفاعل العميل التالي مع عنوان تم الإبلاغ عنه بجودة رديئة، يمكنك استدعاء واجهة برمجة تطبيقات التحقق من صحة العناوين باستخدام واجهة برمجة تطبيقات الخاص بك. ستعرض واجهة برمجة تطبيقات التحقق من صحة العنوان العنوان الذي تم تصحيحه التي يمكن عرضها باستخدام مطالبة واجهة المستخدم. بعد أن يقبل العميل العنوان المنسَّق يمكنك التخزين المؤقت لما يلي من الرد:

• formattedAddress
• postalAddress
• addressComponent componentNamesأو
• UspsData standardizedAddress

تنفيذ عملية التحقّق من صحة عنوان بلا واجهة مستخدم رسومية

بناءً على المناقشة أعلاه:

• غالبًا ما يكون من الضروري تخزين جزء من الرد مؤقتًا من العنوان التحقق من صحة واجهة برمجة التطبيقات لأسباب تجارية.
• ومع ذلك، لا يتم تطبيق بنود الخدمة في تفرض "منصة خرائط Google" قيودًا على البيانات التي يمكن تخزينها في ذاكرة التخزين المؤقت.

في القسم التالي، سنناقش عملية مكونة من خطوتين حول كيفية التوافق لبنود الخدمة وتنفيذ عدد كبير من عمليات التحقق من العنوان.

الخطوة 1:

في الخطوة الأولى، سنتطرق إلى كيفية تطبيق عنوان كبير الحجم. البرنامج النصي للتحقق من صحة البيانات من مسار بيانات موجود. ستتيح لك هذه العملية تخزين حقول معينة من رد واجهة برمجة تطبيقات التحقق من صحة العنوان في البنود طريقة متوافقة مع الخدمة.

الرسم البياني أ: يوضّح المخطّط التالي كيفية تحسين أحد مسارات البيانات. باستخدام منطق "التحقق من العناوين بكميات كبيرة".

ووفقًا لبنود الخدمة، يمكنك تخزين البيانات التالية مؤقتًا من addressComponent:

• confirmationLevel
• inferred
• spellCorrected
• replaced
• unexpected

من هنا، خلال هذه الخطوة من التنفيذ، نخزّن المعلومات المذكورة أعلاه في ذاكرة التخزين المؤقت. مختلفة مقابل UserID.

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على تفاصيل حول البيانات الفعلية الهيكلية.

الخطوة 2:

في الخطوة الأولى، جمعنا ملاحظات مفادها أن بعض العناوين في مجموعة بيانات الإدخال قد ألا تكون عالية الجودة. في الخطوة التالية، سنأخذ هذه العناوين التي تم الإبلاغ عنها وتقديمها إلى المستخدم والحصول على موافقته على تصحيح البيانات المخزنة الخاص بك.

المخطّط ب: يوضّح هذا المخطّط البياني كيفية الدمج التام بين الأطراف يمكن أن يبدو تدفق الموافقة كما يلي:

1. عندما يسجِّل المستخدم دخوله، تحقَّق أولاً مما إذا كان قد تم تخزين أي علامات تحقُّق مؤقتًا. في نظامك.
2. إذا كانت هناك علامات، فيجب عليك تقديم واجهة مستخدم لتصحيح تحديث عنوانه.
3. يمكنك استدعاء واجهة برمجة تطبيقات التحقق من صحة العنوان مرة أخرى مع تحديث واجهة برمجة التطبيقات أو ذاكرة التخزين المؤقت وتقديم العنوان المصحَّح للمستخدم للتأكيد.
4. إذا كان العنوان عالي الجودة، فستعرض واجهة برمجة تطبيقات التحقق من صحة العنوان formattedAddress
5. ويمكنك إما تقديم هذا العنوان للمستخدم إذا كانت التصحيحات أو الموافقة عليها بدون تنبيه إذا لم تكن هناك تصحيحات.
6. وبعد موافقة المستخدم، يمكنك تخزين "formattedAddress" مؤقتًا في قاعدة البيانات.

الخاتمة

إنّ "التحقّق من صحة العنوان بكميات كبيرة" هي حالة استخدام شائعة من المحتمل أن تواجهها في العديد من التطبيقات. تحاول هذه الوثيقة توضيح بعض السيناريوهات نمط تصميم حول كيفية تنفيذ هذا الحل بما يتوافق مع "خرائط Google" بنود خدمة النظام الأساسي

لقد كتبنا أيضًا مرجعًا لـ "عنوان كبير الحجم". التحقق من الصحة كمكتبة مفتوحة المصدر على GitHub. الاطّلاع على التفاصيل للبدء المبنى مع التحقق من العناوين بكميات كبيرة بسرعة. يمكنك أيضًا الانتقال إلى المقالة عن أنماط تصميم لكيفية استخدام المكتبة في سيناريوهات مختلفة.

الخطوات التالية

نزِّل مقالة تحسين الدفع والتسليم والعمليات باستخدام عناوين موثوق بها. التقرير الموجز وعرض صفحة تحسين الدفع والتسليم والعمليات باستخدام العنوان التحقق من صحة برنامج تعليمي على الويب

قراءة إضافية مقترَحة:

• تطبيقات التحقق من العناوين بكميات كبيرة
• مكتبة Python على GitHub
• استكشاف demo لـ Address التحقق من صحة

المساهمون

تحتفظ Google بهذه المقالة. كتبه المساهمون التاليون في الأصل.
المؤلفون الرئيسيون:

هنريك فالف | مهندس الحلول
توماس Anglaret | الحلول المهندس
سارثاك غانغولي | الحلول المهندس