قبول العنوان - أمثلة

يوضِّح هذا المستند عددًا من السيناريوهات الواقعية التي توفّر فيها واجهة برمجة التطبيقات للتحقق من صحة العنوان الجغرافي إشارات استجابة تضمن سلوك قبول من نظامك. يمكنك الاطّلاع على نظرة عامة على سير العمل في استخدام رد التحقق من الصحة للحصول على السياق.

مثال شائع: قبول

يوضح هذا السيناريو عنوانًا يقبل نظامك فيه العنوان الذي يدخله العميل.

تم إدخال العنوان منطقة
76 Buckingham Palace Road, London SW1W 9TQ المملكة المتحدة

بيان عنوان مقبول

ويسلط المثال التالي الضوء على الإشارات المهمة.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

بالإضافة إلى ذلك، تشير الاستجابة إلى ما يلي:

  • سيبقى hasUnconfirmedComponents false
  • سيبقى hasInferredComponents false
  • سيبقى hasReplacedComponents false

تشير هذه الإشارات عند دمجها معًا إلى عنوان عالي الجودة.

أمثلة على الحالة الحدّية: قبول

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

رقم الشارع غير مؤكَّد في الولايات المتحدة

يوضّح هذا المثال إدخال عنوان إيطالي يحتوي على جميع مكوّنات العنوان، بدون أي مكوّنات مستنتَجة أو تم استبدالها. في المقابل، قيمة validationGranularity هي ROUTE.

تم إدخال العنوان منطقة
Via Fonte Grugnale، 14 وحدة 2، 66054 فاستو CH، إيطاليا إيطاليا

الحكم بشأن رقم شارع غير مؤكَّد

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

بعد إجراء المزيد من التحقيقات حول مكونات العنوان، تم الكشف عن أنّ رقم الشارع هو UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

لم يتم تأكيد رقم الشارع في الولايات المتحدة.

يوضّح هذا المثال إدخال عنوان في الولايات المتحدة الأمريكية مع وجود جميع مكوّنات العنوان، بدون أي مكوّنات مستنتَجة أو تم استبدالها. في المقابل، قيمة validationGranularity هي PREMISE_PROXIMITY.

تم إدخال العنوان منطقة
975 Carson Dr, Sunnyvale, CA 94086 الولايات المتحدة

بيانات من هيئة النقل والفضاء الأمريكية (USPS) لرقم شارع غير مؤكَّد

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

بيانات غير مكتملة من USPS لعنوان تم تأكيده

يوضّح هذا المثال إدخال عنوان في الولايات المتحدة تم تأكيد جميع مكوّنات العنوان بدون استنتاج أو استبدال أي عناصر، واستخدام validationGranularity لـ PREMISE. ومع ذلك، لا تتم تعبئة uspsData بالكامل ولا يحتوي على قيمة dpvConfirmation.

تم إدخال العنوان منطقة
155 Via Condado Way, Palm Park Garden, FL 33418-1703 الولايات المتحدة

قرار عنوان تم تأكيده بسبب عدم اكتمال بيانات USPS

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

بيانات USPS لعنوان تم تأكيده مع بيانات غير مكتملة من USPS

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}