يوضِّح هذا المستند عددًا من السيناريوهات الواقعية التي توفّر فيها واجهة برمجة التطبيقات للتحقق من صحة العنوان الجغرافي إشارات استجابة تضمن سلوك قبول من نظامك. يمكنك الاطّلاع على نظرة عامة على سير العمل في استخدام رد التحقق من الصحة للحصول على السياق.
مثال شائع: قبول
يوضح هذا السيناريو عنوانًا يقبل نظامك فيه العنوان الذي يدخله العميل.
تم إدخال العنوان | منطقة |
---|---|
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"
}