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") أو رقم بمفرده يمثل "رمز القطاع" (جامايكا) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال، كوت ديفوار).

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

يُعد العنوان مكتملاً في حال عدم وجود رموز مميزة لم يتم حلها، أو عدم وجود مكونات عنوان غير متوقعة أو مفقودة. في حال ترك هذه السياسة بدون ضبط، يعني ذلك أنّ القيمة هي false. يمكنك الاطّلاع على الحقول 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

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

string

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

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

object (LatLng)

الموقع الجغرافي للإدخال المرمَّز جغرافيًا.

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

object (PlusCode)

تمثّل هذه السمة رمز Plus Codes المتوافق مع 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 x 1/8000 درجة (حوالي 14 × 14 متر)

string

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

{
  "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

رقم اختبار نقطة التسليم. تتم إضافة هذا الرقم إلى نهايةdelivery_point_barcode للبريد الذي يتم مسحه ضوئيًا آليًا. يجب أن تؤدي إضافة كل أرقام العنوانdelivery_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 أو HC غير صالح
• 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 - يوم الثلاثاء هو يوم عدم التسليم 0x08 - يوم الثلاثاء هو يوم عدم التسليم 0x08 - ويوم الأربعاء هو يوم عدم التسليم 0x04 - يوم الخميس هو يوم عدم التسليم 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: شركة FIRM يتطابق هذا مع السجل الثابت، وهو أفضل مستوى من المطابقة المتاح للعنوان.
• G: التسليم العام يتطابق هذا مع سجلّ تسليم عام.
• H: مبنى / شقة يتطابق هذا مع سجلّ مبنى أو شقة.
• P: مربّع مكتب البريد هذا مطابق لصندوق بريد.
• R: مسار ريفي أو عقد طريق سريع: يتطابق هذا الخيار مع سجل مسار ريفي أو عقد طريق سريع، وقد يحتوي كلاهما على نطاقات أرقام صندوقية مرتبطة.
• S: سجلّ الشارع: يتطابق هذا مع سجلّ شارع يحتوي على نطاق أرقام أساسي صالح.

boolean

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

string

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

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

boolean

مؤشر على أنه تمت معالجة الطلب باستخدام CASS

{
  "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