Method: validateAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

النسخة السابقة من المخطط من PostalAddress. وستؤدي أي قيمة أخرى بخلاف 0 إلى عرض واجهة برمجة التطبيقات للخطأ INVALID_ARGUMENT.

string

اختياريّ. رمز CLDR للمنطقة للدولة/المنطقة حيث يقع العنوان للاطّلاع على التفاصيل، يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. على سبيل المثال: "CH" لسويسرا. إذا لم يتم تقديم رمز المنطقة، سيتم استنتاجه من العنوان. لتحقيق أفضل أداء، ننصحك بتضمين رمز المنطقة إذا كنت تعرفه. قد يؤدي استخدام مناطق غير متسقة أو متكرّرة إلى ضعف الأداء. على سبيل المثال، إذا كانت addressLines تتضمّن المنطقة، يُرجى عدم إدخال رمز المنطقة مرة أخرى في هذا الحقل. يمكنك العثور على المناطق التي تتوفّر فيها هذه الميزة في الأسئلة الشائعة.

string

يكون رمز اللغة في عنوان الإدخال محجوزًا للاستخدامات المستقبلية، ويتم تجاهله اليوم. تعرض واجهة برمجة التطبيقات العنوان باللغة المناسبة لمكان العنوان.

string

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

string

اختياريّ. رمز ترتيب إضافي خاص بالبلد ولا يتم استخدام هذه الطريقة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة برقم اختياري (مثل "CEDEX 7")، أو رقم فقط يمثّل "رمز القطاع" (Jamaica) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج).

string

اختياريّ. أعلى تقسيم فرعي إداري يُستخدم للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. وعلى وجه التحديد، بالنسبة إلى إسبانيا، تكون هذه المقاطعة وليست المجتمع المستقل (مثل "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. في سويسرا مثلاً، يجب ترك هذا الحقل فارغًا.

string

اختياريّ. يشير بوجه عام إلى جزء المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، مدينة البريد في المملكة المتحدة. في مناطق العالم حيث لم يتم تعريف المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل بشكل جيد، اترك المنطقة المحلية فارغة واستخدم addressLines.

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن يشمل ذلك الأحياء والأحياء والأحياء.

string

مطلوبة. أسطر عناوين غير مهيكلة تصف المستويات الأدنى من العنوان.

نظرًا لأن القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال "أوستن، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب سطور العنوان هو "ترتيب المغلف" للبلد/منطقة العنوان.

يتألف الحد الأدنى المسموح به من التمثيل الهيكلي للعنوان من جميع المعلومات الموضوعة في addressLines. إذا لم يتم تقديم regionCode، يتم استنتاج المنطقة من سطور العنوان.

إنشاء عنوان يحتوي على addressLines فقط، ثم الترميز الجغرافي هو الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).

string

يُرجى تجنُّب ضبط هذا الحقل. واجهة برمجة تطبيقات التحقق من صحة العنوان لا تستخدمها حاليًا. وعلى الرغم من أنّ واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات التي تم تحديد مجموعة الحقول هذه فيها، سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة.

string

يُرجى تجنُّب ضبط هذا الحقل. واجهة برمجة تطبيقات التحقق من صحة العنوان لا تستخدمها حاليًا. وعلى الرغم من أنّ واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات التي تم تحديد مجموعة الحقول هذه فيها، سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة.

{
  "returnEnglishLatinAddress": boolean
}

boolean

معاينة: عرض google.maps.addressvalidation.v1.Address باللغة الإنجليزية لمزيد من التفاصيل، انتقلي إلى google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}

object (Verdict)

علامات القرار العامة

object (Address)

معلومات حول العنوان نفسه بخلاف الرمز الجغرافي.

object (Geocode)

معلومات عن الموقع الجغرافي والمكان الذي تم ترميز العنوان الجغرافي إليه.

object (AddressMetadata)

معلومات أخرى ذات صلة بالتسليم. لا نضمن لك تعبئة metadata بالكامل لكل عنوان يتم إرساله إلى واجهة برمجة التطبيقات للتحقّق من صحة العنوان.

object (UspsData)

علامات إضافية للتسليم مقدَّمة من USPS. يتوفّر هذا الخيار فقط في المنطقتَين US وPR.

object (Address)

المعاينة: تتوفّر هذه الميزة ضمن المعاينة (مرحلة ما قبل التوفّر للجمهور العام). قد تحظى منتجات وميزات مرحلة ما قبل التوفّر للجمهور العام بدعم محدود، وقد لا تتوافق التغييرات التي يتم إجراؤها على منتجات وميزات مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مرحلة الإطلاق.

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

لقد فعّلت هذه النتيجة باستخدام العلامة google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

ملاحظة: لا تتم تعبئة الحقل google.maps.addressvalidation.v1.Address.unconfirmed_component_types في الحقلَين englishLatinAddress وgoogle.maps.addressvalidation.v1.AddressComponent.confirmation_level في englishLatinAddress.address_components.

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

دقة عنوان الإدخال. وينتج ذلك عن تحليل عنوان الإدخال ولا يعطي أيّ إشارات للتحقّق من الصحة. للاطّلاع على إشارات التحقق من الصحة، يُرجى الرجوع إلى validationGranularity أدناه.

على سبيل المثال، إذا كان العنوان الذي تم إدخاله يتضمّن رقم شقة معيّنًا، ستكون قيمة inputGranularity هنا هي SUB_PREMISE. إذا لم نتمكّن من مطابقة رقم الشقة في قواعد البيانات أو كان رقم الشقة غير صالح، ستكون القيمة validationGranularity على الأرجح PREMISE أو أقل.

enum (Granularity)

مستوى الدقة الذي يمكن لواجهة برمجة التطبيقات validate منه بشكل كامل في العنوان. على سبيل المثال، تشير السمة validationGranularity للسمة PREMISE إلى أنّه يمكن التحقق من جميع مكوّنات العناوين على مستوى PREMISE أو أقل دقة.

يمكن العثور على نتيجة التحقق من صحة مكوّن العنوان في google.maps.addressvalidation.v1.Address.address_components.

enum (Granularity)

تمثّل هذه السمة معلومات عن مستوى دقة geocode. يمكن فهم هذا على أنه المعنى الدلالي لمدى فرط أو دقة الموقع الجغرافي الذي تم ترميزه جغرافيًا.

يمكن أن يختلف هذا الخيار عن validationGranularity أعلاه في بعض الأحيان. على سبيل المثال، قد تسجل قاعدة البيانات لدينا وجود رقم شقة ولكن ليس لها موقع دقيق للشقة داخل مجمع سكني كبير. في هذه الحالة، سيكون validationGranularity SUB_PREMISE، في حين أنّ geocodeGranularity سيكون PREMISE.

boolean

يُعتبر العنوان كاملاً في حال عدم وجود رموز مميزة لم يتم حلها أو عدم وجود مكونات عنوان غير متوقعة أو مفقودة. يمكنك الاطّلاع على حقول missingComponentTypes أو unresolvedTokens أو unexpected للحصول على مزيد من التفاصيل.

boolean

لا يمكن تصنيف أو التحقّق من مكوّن عنوان واحد على الأقل. لمزيد من التفاصيل، يُرجى الاطّلاع على google.maps.addressvalidation.v1.Address.address_components.

boolean

تم استنتاج (إضافة) مكوّن عنوان واحد على الأقل غير مُضمَّن في الإدخال، يُرجى الاطّلاع على google.maps.addressvalidation.v1.Address.address_components لمزيد من التفاصيل.

boolean

تم استبدال مكوِّن عنوان واحد على الأقل. يُرجى الاطّلاع على google.maps.addressvalidation.v1.Address.address_components للحصول على التفاصيل.

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

العنوان الذي تمت معالجته بعد المعالجة، ويكون منسَّقًا كعنوان مكوّن من سطر واحد وفقًا لقواعد تنسيق العنوان للمنطقة التي يقع فيها العنوان.

object (PostalAddress)

يتم تمثيل العنوان الذي تمّت معالجته بعد ذلك كعنوان بريدي.

object (AddressComponent)

قائمة بدون ترتيب. مكونات العنوان الفردي للعنوان الذي تم تنسيقه وتصحيحه، بالإضافة إلى معلومات التحقق من الصحة. يوفر هذا معلومات عن حالة التحقق من المكونات الفردية.

لا يتم ترتيب مكونات العنوان بطريقة معينة. عدم وضع أي افتراضات بشأن ترتيب مكونات العنوان في القائمة

string

أنواع المكوّنات التي كان من المتوقع أن تكون متوفرة في عنوان بريدي منسق بشكل صحيح ولكن لم يتم العثور عليها في الإدخال وتعذر استنتاجها. مكونات هذا النوع غير موجودة في formattedAddress أو postalAddress أو addressComponents. على سبيل المثال: ['street_number', 'route'] لإدخال مثل "بولدر، كولورادو، 80301، الولايات المتحدة الأمريكية". يمكنك العثور على قائمة بالأنواع المحتملة هنا.

string

تمثّل هذه السمة أنواع المكوّنات المتوفّرة في addressComponents ولكن تعذّر التأكّد من صحتها. تم توفير هذا الحقل لتسهيل الأمر: يماثل محتواه التكرار من خلال addressComponents للعثور على أنواع جميع المكوّنات التي لا تكون فيها العلامة confirmationLevel CONFIRMED أو لم يتم ضبط العلامة inferred على true. يمكنك العثور على قائمة بالأنواع المحتملة هنا.

string

أي رموز مميزة في الإدخال تعذُّر حلها. قد يكون هذا إدخالاً لم يتم التعرف عليه باعتباره جزءًا صالحًا من العنوان (على سبيل المثال، في إدخال مثل "123235253253 Main St, San Francisco, CA, 94105"، فقد تبدو الرموز المميزة التي لم يتم حلها على النحو ["123235253253"] لأنه لا يبدو كرقم شارع صالح.

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

اسم هذا المكوِّن.

string

نوع عنصر العنوان. راجع الجدول 2: الأنواع الإضافية التي تعرضها خدمة الأماكن للحصول على قائمة بالأنواع المحتملة.

enum (ConfirmationLevel)

تشير إلى مستوى اليقين الذي لدينا من صحة المكون.

boolean

يشير إلى أن المكوِّن لم يكن جزءًا من الإدخال، ولكننا استنتجنا ذلك لموقع العنوان ونعتقد أنه يجب تقديمه لعنوان كامل.

boolean

يشير إلى تصحيح لخطأ إملائي في اسم المكوِّن. ويُرجى العِلم أنّ واجهة برمجة التطبيقات لا تُبلغ دائمًا عن التغييرات من صيغة إملائية إلى أخرى، كما هو الحال عند تغيير كلمة "مركز" إلى "مركز". ولا يتم دائمًا وضع علامة على الأخطاء الإملائية الشائعة، مثل تغيير "Amphitheater Pkwy" إلى "Amphitheatre Pkwy".

boolean

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

boolean

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

{
  "text": string,
  "languageCode": string
}

string

نص الاسم. على سبيل المثال، "5 شارع" لاسم شارع أو "1253" لرقم شارع.

string

تمثّل هذه السمة رمز اللغة BCP-47. لن يكون هذا موجودًا إذا كان اسم المكون غير مرتبط بلغة، مثل رقم الشارع.

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

الموقع الجغرافي للإدخال والذي تم ترميزه جغرافيًا.

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

object (PlusCode)

رمز الموقع المفتوح المقابل لـ location.

object (Viewport)

حدود المكان المرمز جغرافيًا.

number

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

string

تمثّل هذه السمة رقم تعريف المكان للمكان الذي توجد فيه الرموز الجغرافية لهذا الإدخال.

لمزيد من المعلومات عن أرقام تعريف الأماكن، اطّلِع هنا.

string

نوع(أنواع) المكان الذي تم ترميز الإدخال جغرافيًا إليه. مثلاً: ['locality', 'political'] يمكنك الاطّلاع على القائمة الكاملة للأنواع هنا.

{
  "latitude": number,
  "longitude": number
}

number

تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضِمن نطاق [ -90.0 أو +90.0].

number

خط الطول بالدرجات. يجب أن يكون ضمن النطاق [-180.0، +180.0].

{
  "globalCode": string,
  "compoundCode": string
}

string

رمز المكان العالمي (الكامل)، مثل "9FWM33GV+HQ"، الذي يمثّل مساحة 1/8000 درجة × 1/8000 درجة (حوالي 14 × 14 مترًا).

string

الرمز المركّب للمكان، مثل " 33GV+HQ, Ramburg, النرويج"، الذي يحتوي على لاحقة الرمز العام واستبدال البادئة باسم منسَّق لكيان مرجعي

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

مطلوبة. النقطة المنخفضة لإطار العرض.

object (LatLng)

مطلوبة. النقطة العليا في إطار العرض.

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

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

boolean

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

boolean

يشير إلى أن هذا هو عنوان الإقامة. في حال ترك هذه السياسة بدون ضبط، يعني ذلك أنّ القيمة غير معروفة.

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

هو عنوان موحّد لـ USPS.

string

رمز نقطة التسليم المكوّن من رقمَين

string

رقم اختبار نقطة التسليم. تتم إضافة هذا الرقم إلى نهايةDeliver_point_barcode للبريد الإلكتروني الممسوح ضوئيًا آليًا. يجب أن ينتج عن جمع كل أرقام رمز التسليم_point_barcode وdeliveryPointCheckDigit والرمز البريدي وZIP+4 معًا رقمًا يمكن قسمته على 10.

string

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

• N: تعذّر تأكيد معلومات الأرقام الأساسية وأي أرقام ثانوية في DPV.
• D: تم تأكيد DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي غير متوفّرة.
• S: تم تأكيد DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوية متوفّرة ولكن لم يتم تأكيدها.
• Y: تم تأكيد عنوان DPV للأرقام الأساسية وأي أرقام ثانوية.
• فارغ: إذا لم يكن الردّ يحتوي على قيمة dpvConfirmation، هذا يعني أنه لم يتم إرسال العنوان لتأكيد DPV.

string

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

• AA: تطابق عنوان الإدخال مع ملف ZIP+4
• A1: لم تتم مطابقة عنوان الإدخال مع ملف ZIP+4
• BB: تتم المطابقة مع DPV (جميع المكوّنات)
• CC: الرقم الثانوي غير متطابق وغير مطلوب
• C1: الرقم الثانوي غير مطابق ولكنه مطلوب
• N1: رقم التعريف الثانوي غير متوفّر في عنوان شاهق
• M1: الرقم الأساسي مفقود
• M3: الرقم الأساسي غير صالح
• P1: رقم صندوق العنوان الخاص بالإدخال أو رقم RR أو HC غير متوفّر
• P3: رقم صندوق البريد أو رقم RR أو عنوان الإدخال غير صالح.
• F1: تطابق عنوان الإدخال مع عنوان عسكري
• G1: تطابق عنوان الإدخال مع عنوان تسليم عام
• U1: تطابق عنوان الإدخال مع رمز بريدي فريد
• PB: عنوان الإدخال مطابق لسجلّ PBSA
• RR: تم تأكيد عنوان DPV مع معلومات PMB.
• R1: عنوان DPV الذي تم تأكيده بدون معلومات PMB
• R7: سجل مسار شركة النقل R777 أو R779
• IA: تم تحديد عنوان مطّلع.
• TA: الرقم الأساسي الذي تمت مطابقته بإسقاط ألفا لاحقة

string

يشير إلى ما إذا كان العنوان وكالة استقبال البريد التجاري (CMRA)--نشاط تجاري خاص يتلقى رسائل للعملاء. تعرض حرفًا واحدًا.

• Y: العنوان هو CMRA
• N: العنوان ليس هيئة CMRA

string

هل هذا المكان شاغر؟ تعرض حرفًا واحدًا.

• Y: العنوان شاغر
• N: العنوان ليس شاغرًا

string

هل هذا عنوان بدون إحصائيات أو عنوان نشط؟ لا توجد عناوين إحصائيات هي العناوين التي لا يتم شغلها باستمرار أو العناوين التي لا تقدم لها USPS. تعرض حرفًا واحدًا.

• Y: العنوان غير نشط
• N: العنوان نشط

integer

يشير إلى نوع NoStat. لعرض رمز السبب كعدد صحيح

• 1: IDA (عنوان البريد الإلكتروني الداخلي) - العناوين التي لا تتلقى الرسائل الإلكترونية مباشرة من USPS ولكن يتم تسليمها إلى عنوان بريد إلكتروني مخصص لها.
• 2: أداة "CDS": العناوين التي لم يتم تسليمها بعد على سبيل المثال، قسم فرعي جديد تم فيه تحديد الكثير والأرقام الأساسية، ولكن لا يوجد هيكل حتى الآن للإشغال.
• 3: تصادم - العناوين التي لا يتم تأكيد DPV فيها
• 4: CMZ (الكلية والعسكرية والأنواع الأخرى) - ZIP + 4 سجلات تم دمجها بواسطة USPS في البيانات.
• 5: عادي: يشير إلى العناوين التي لا تتلقّى خدمة التسليم، ولا يتم احتساب العناوين كعمليات تسليم ممكنة.
• 6: ثانوي مطلوب - يتطلّب العنوان معلومات ثانوية.

string

تشير العلامة إلى تسليم البريد إلى شخص واحد مستلم على موقع إلكتروني. تعرض حرفًا واحدًا.

• Y: يتم تسليم البريد إلى شخص واحد قابل للاستلام على أحد المواقع الإلكترونية.
• N: لا يتم تسليم الرسالة إلى شخص واحد قابل للاستلام على أحد المواقع الإلكترونية.

string

يشير إلى عدم تسليم البريد إلى عنوان الشارع. تعرض حرفًا واحدًا.

• Y: لا يتم تسليم الرسالة إلى عنوان الشارع.
• N: يتم تسليم البريد إلى عنوان الشارع.

string

تشير العلامة إلى أنّه لا يتم تسليم البريد في كل يوم من أيام الأسبوع. تعرض حرفًا واحدًا.

• Y: لا يتم تسليم البريد في كل يوم من أيام الأسبوع.
• N: ليس هناك ما يشير إلى أنّه لا يتم تسليم البريد في كل يوم من أيام الأسبوع.

integer

عدد صحيح يحدِّد أيام عدم التسليم يمكن استجوابه باستخدام علامات بت: 0x40 – الأحد هو يوم عدم التسليم 0x20 – يوم الاثنين هو يوم عدم التسليم 0x10 – يوم الثلاثاء هو يوم عدم التسليم 0x10 – الثلاثاء هو يوم عدم التسليم 0x08 – الأربعاء هو يوم عدم التسليم 0x04 – يوم الخميس هو يوم عدم التسليم 0x02 – يوم الأحد هو يوم عدم التسليم 0x02 – يوم الجمعة هو يوم عدم التسليم 0x02 – يوم الثلاثاء هو يوم عدم التسليم 0x02 – يوم الثلاثاء هو يوم عدم التسليم 0x02 – يوم السبت هو يوم عدم التسليم 0x02 – يوم السبت هو يوم عدم التسليم 0x02 – يوم الجمعة

string

تشير العلامة إلى إمكانية الوصول إلى الباب، ولكن لن يتم ترك الطرد لأسباب تتعلق بالأمان. تعرض حرفًا واحدًا.

• Y: لن يتم ترك الطرد لأسباب تتعلق بالأمان.
• N: ما مِن مؤشر بأنّه لن يتم ترك الطرد لأسباب تتعلّق بالأمان.

string

يشير إلى تطابق العنوان مع سجلّ PBSA. تعرض حرفًا واحدًا.

• Y: تمت مطابقة العنوان بسجلّ PBSA.
• N: لم يتطابق العنوان مع سجلّ PBSA.

string

تشير العلامة إلى العناوين التي لا يمكن لـ USPS طرقها على باب تسليم البريد. تعرض حرفًا واحدًا.

• Y: لا يمكن الوصول إلى الباب.
• N: ما من مؤشر على تعذُّر الوصول إلى الباب.

string

يشير إلى أنّ أكثر من رمز إرجاع DPV واحد صالح للعنوان. تعرض حرفًا واحدًا.

• Y: تم تأكيد عنوان DPV للأرقام الأساسية وأي أرقام ثانوية.
• N: تعذّر تأكيد معلومات الأرقام الأساسية وأي أرقام ثانوية في DPV.
• S: تم تأكيد DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي غير مؤكدة، أو تم إسقاط رسالة ألفا لاحقة واحدة على رقم أساسي لإجراء مطابقة DPV ومطلوب الحصول على معلومات ثانوية.
• D: تم تأكيد DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي غير متوفّرة.
• R: تم تأكيد العنوان ولكن تم تعيينه للمسار الوهمي R777 وR779، ولم يتم تقديم USPS.

string

رمز مسار شركة النقل. رمز مكون من أربعة أحرف يتكون من بادئة من حرف واحد ومصمم مسار مكون من ثلاثة أرقام.

البادئات:

• C: مسار شركة نقل (أو مسار ضمن المدينة)
• R: طريق ريفية
• H: مسار تعاقدي على الطرق السريعة
• B: قسم صندوق البريد
• G: وحدة توصيل عامة

string

مؤشر فرز معدل مسار شركة النقل.

boolean

عنوان التسليم قابل للمطابقة، ولكن يشير ملف EWS إلى أن مطابقة تامة ستتوفر قريبًا.

string

مدينة مكتب البريد الرئيسية.

string

ولاية مكتب البريد الرئيسي.

string

المدينة المختصرة.

string

رمز FIPS للمقاطعة.

string

اسم المقاطعة.

string

رقم خط السفر المحسَّن (eLOT).

string

علامة eLOT تصاعدية/تنازلية (A/D).

string

رمز إرجاع LACSLink.

string

مؤشر LACSLink

boolean

الرمز البريدي لصندوق البريد فقط

string

حواشي سفلية من مطابقة شارع أو سجل شاهق مع معلومات الجناح. في حال تطابق اسم النشاط التجاري، يتم عرض الرقم الثانوي.

• A: تطابق سجلّ SuiteLink، وتم تحسين عنوان النشاط التجاري.
• 00: لا توجد مطابقة، ولم يتم تحسين عنوان النشاط التجاري.

string

محدِّد وحدة صندوق البريد الخاص (PMB).

string

رقم صندوق البريد الخاص (PMB)

string

نوع سجلّ العنوان الذي يتطابق مع عنوان الإدخال

• F: ثابت. يتطابق هذا مع سجل شركة، وهو أفضل مستوى من التطابق المتاح للعنوان.
• G: تسليم عام يتطابق هذا مع سجل التسليم العام.
• H: مبنى أو شقة يتطابق هذا مع سجل مبنى أو شقة.
• P: صندوق البريد. يتطابق هذا مع صندوق بريد.
• R: عقد الطريق السريع أو عقد الطريق السريع: يتطابق هذا الخيار مع سجل لطريق ريفي أو عقد للطريق السريع، وقد يحتوي كلاهما على نطاقات أرقام صندوقية مرتبطة.
• S: سجل الشارع: يتطابق هذا السجل مع سجل شارع يحتوي على نطاق أرقام أساسي صالح.

boolean

يشير إلى أنه تم العثور على عنوان تلقائي، ولكن هناك عناوين أكثر تحديدًا.

string

رسالة خطأ لاسترداد بيانات USPS. تتم تعبئة هذه المعلومات عندما يتم تعليق معالجة USPS بسبب رصد عناوين تم إنشاؤها بشكل مصطنع.

قد لا تتم تعبئة حقول بيانات USPS عند حدوث هذا الخطأ.

boolean

يشير إلى أن الطلب قد تمت معالجته.

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

السطر الأول من العنوان.

string

اسم الشركة.

string

السطر الثاني من العنوان.

string

اسم التحضر في بورتوريكو.

string

المدينة + الولاية + الرمز البريدي:

string

اسم المدينة.

string

رمز الولاية المكون من حرفين.

string

الرمز البريدي، مثل 10009.

string

إضافة الرمز البريدي المكوّن من 4 أرقام، مثل 5023