Method: validateAddress

للتحقّق من صحة عنوان

طلب HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
الحقول
address

object (PostalAddress)

مطلوب. يتم التحقّق من العنوان. يجب إرسال العناوين غير المنسَّقة عبر addressLines.

يجب ألا يتجاوز إجمالي طول الحقول في هذا الإدخال 280 حرفًا.

يمكنك الاطّلاع على المناطق التي تتوفّر فيها الخدمة هنا.

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

تتجاهل واجهة برمجة التطبيقات Address Validation API القيم في recipients وorganization. وسيتم تجاهل أي قيم في هذه الحقول ولن يتم عرضها. يُرجى عدم ضبطها.
previousResponseId

string

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

boolean

تفعيل الوضع المتوافق مع USPS CASS لا يؤثر ذلك إلا في حقل google.maps.addressvalidation.v1.ValidationResult.usps_data في google.maps.addressvalidation.v1.ValidationResult. ملاحظة: بالنسبة إلى طلبات العناوين في بورتوريكو التي تم تفعيل نظام CASS من USPS لها، يجب تقديم google.type.PostalAddress.region_code من address على أنّه "PR"، أو يجب تقديم google.type.PostalAddress.administrative_area من address على أنّه "بورتوريكو" (لا تُراعَى حالة الأحرف) أو "PR".

ننصحك باستخدام address مكوّن، أو تحديد google.type.PostalAddress.address_lines على الأقل يتضمّن السطر الأول رقم الشارع واسمه والسطر الثاني المدينة والولاية والرمز البريدي.
languageOptions

object (LanguageOptions)

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

يتيح هذا الخيار لواجهة برمجة التطبيقات Address Validation API تضمين معلومات إضافية في الردّ.
sessionToken

string

اختياريّ. سلسلة تحدِّد جلسة الإكمال التلقائي لأغراض الفوترة يجب أن تكون سلسلة base64 آمنة لعنوان URL واسم الملف، ويجب ألا يزيد طولها عن 36 حرفًا ASCII. بخلاف ذلك، يتم عرض الخطأ INVALID_ARGUMENT.

تبدأ الجلسة عندما يُجري المستخدم طلب بحث في ميزة "الإكمال التلقائي"، وتنتهي عندما يختار مكانًا ويتم إجراء طلب إلى "تفاصيل المكان" أو "إثبات صحة العنوان". يمكن أن تحتوي كل جلسة على طلبات بحث متعددة من خلال ميزة "الإكمال التلقائي"، متبوعة بطلب واحد من طلبات "تفاصيل المكان" أو "التحقّق من العنوان". يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب ضمن جلسة إلى مشروع Google Cloud Console نفسه. بعد انتهاء الجلسة، لن يعود الرمز المميّز صالحًا، ويجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة. في حال حذف المَعلمة sessionToken أو إعادة استخدام رمز تعريف جلسة، يتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز تعريف جلسة (يتم فوترة كل طلب بشكل منفصل).

ملاحظة: لا يمكن استخدام ميزة "التحقّق من العنوان" إلا في الجلسات التي تستخدم واجهة برمجة التطبيقات الخاصة بميزة "الإكمال التلقائي (الإصدار الجديد)"، وليس واجهة برمجة التطبيقات الخاصة بميزة "الإكمال التلقائي". اطّلِع على https://developers.google.com/maps/documentation/places/web-service/session-pricing لمزيد من التفاصيل.

نص الاستجابة

ردّ على طلب التحقّق من عنوان

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
الحقول
result

object (ValidationResult)

نتيجة عملية إثبات صحة العنوان
responseId

string

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

PostalAddress

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

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

نصائح حول إدخال العناوين أو تعديلها: - استخدِم تطبيق مصغّر للعناوين متوافقًا مع الترجمة والنشر في لغات متعددة، مثل https://github.com/google/libaddressinput. - يجب عدم عرض عناصر واجهة مستخدِم للمستخدمين لإدخال حقول أو تعديلها خارج البلدان التي يتم استخدام هذا الحقل فيها.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطّط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478.

تمثيل JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

integer

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

string

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

string

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

string

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

string

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

string

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

string

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

string

اختياريّ. البلدة الفرعية للعنوان على سبيل المثال، يمكن أن يكون حيًا أو منطقة إدارية أو دائرة.
addressLines[]

string

مطلوب. سطور عناوين غير منظَّمة تصف المستويات الدنيا للعنوان

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

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

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

string

يُرجى تجنُّب ضبط هذا الحقل. ولا تستخدِم واجهة برمجة التطبيقات Address Validation API هذا الإجراء حاليًا. على الرغم من أنّ واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات التي تم ضبط هذا الحقل فيها، سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة.
organization

string

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

LanguageOptions

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

يتيح هذا الخيار لواجهة برمجة التطبيقات Address Validation API تضمين معلومات إضافية في الردّ.

تمثيل JSON 
{
  "returnEnglishLatinAddress": boolean
}
الحقول
returnEnglishLatinAddress

boolean

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

ValidationResult

نتيجة التحقّق من عنوان

تمثيل JSON 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
الحقول
verdict

object (Verdict)

علامات البيان العام
address

object (Address)

معلومات عن العنوان نفسه بدلاً من الترميز الجغرافي
geocode

object (Geocode)

معلومات عن الموقع الجغرافي والمكان الذي تم ترميز العنوان جغرافيًا به
metadata

object (AddressMetadata)

معلومات أخرى ذات صلة بإمكانية التسليم لا يمكن ضمان تعبئة الحقل metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.
uspsData

object (UspsData)

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

object (Address)

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

العنوان المترجَم إلى الإنجليزية

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

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

يمكنك تفعيل هذا الإخراج باستخدام العلامة 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.

النتيجة

نظرة عامة على مستوى عالٍ حول نتيجة التحقّق من العنوان والرقم الجغرافي

تمثيل JSON 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
الحقول
inputGranularity

enum (Granularity)

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

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

enum (Granularity)

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

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

enum (Granularity)

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

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

boolean

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

boolean

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

boolean

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

boolean

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

الدقة

المستويات المختلفة من الدقة التي يمكن أن يمتلكها العنوان أو الرمز الجغرافي عند استخدامها للإشارة إلى درجة دقة عنوان، تشير هذه القيم إلى درجة الدقة التي يحدّد بها العنوان وجهة إرسال البريد. على سبيل المثال، يحدِّد عنوان مثل "123 Main Street, Redwood City, CA, 94061" PREMISE، في حين يحدِّد عنوان مثل "Redwood City, CA, 94061" LOCALITY. ومع ذلك، إذا تعذّر علينا العثور على رمز جغرافي لـ "123 Main Street" في Redwood City، قد يكون الرمز الجغرافي الذي يتم عرضه بدقة LOCALITY على الرغم من أنّ العنوان أكثر دقة.

عمليات التعداد
GRANULARITY_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
SUB_PREMISE نتيجة على مستوى أقل من مستوى المبنى، مثل شقة
PREMISE نتيجة على مستوى المبنى
PREMISE_PROXIMITY ترميز جغرافي يقترب من الموقع الجغرافي للعنوان على مستوى المبنى
BLOCK يشير العنوان أو الرمز الجغرافي إلى مجموعة. لا يتم استخدامها إلا في المناطق التي تستخدم العناوين على مستوى الكتل، مثل اليابان.
ROUTE يكون الرمز الجغرافي أو العنوان دقيقًا للمسار، مثل شارع أو طريق أو طريق سريع.
OTHER جميع الدقائق الأخرى التي يتم تجميعها معًا لأنّها غير قابلة للعرض

العنوان

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

تمثيل JSON 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
الحقول
formattedAddress

string

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

ملاحظة: قد لا يتطابق تنسيق هذا العنوان مع تنسيق العنوان في الحقل postalAddress. على سبيل المثال، يمثّل الرمز postalAddress دائمًا البلد على شكل regionCode مكوّن من حرفَين، مثل "US" أو "NZ". في المقابل، يستخدم هذا الحقل صيغة أطول لاسم البلد، مثل "الولايات المتحدة الأمريكية" أو "نيوزيلندا".
postalAddress

object (PostalAddress)

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

object (AddressComponent)

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

لا يتم ترتيب مكوّنات العنوان بطريقة معيّنة. لا تفترض أي ترتيب لعناصر العنوان في القائمة.
missingComponentTypes[]

string

أنواع المكوّنات التي كان من المتوقّع أن تكون متوفّرة في عنوان بريدي منسّق بشكل صحيح ولكن لم يتم العثور عليها في الإدخال ولم يكن من الممكن استنتاجها. على سبيل المثال، ['street_number', 'route'] لإدخال مثل "Boulder, Colorado, 80301, USA". يمكنك الاطّلاع على قائمة الأنواع المحتمَلة هنا.

ملاحظة: قد يظهر لك نوع مكوّن غير متوفّر عندما تعتقد أنّك قد قدّمت المكوّن غير المتوفّر. على سبيل المثال، يمكن أن يحدث ذلك عندما يحتوي عنوان الإدخال على اسم المبنى، ولكن ليس رقم المبنى. في العنوان "渋谷区渋谷３丁目　Shibuya Stream"، يحتوي اسم المبنى "Shibuya Stream" على نوع المكوّن premise، ولكن لا يتوفّر رقم المبنى، لذا سيحتوي missingComponentTypes على premise.
unconfirmedComponentTypes[]

string

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

string

أي رموز مميّزة في الإدخال تعذّر حلّها قد يكون هذا إدخالًا لم يتم التعرّف عليه كجزء صالح من عنوان. على سبيل المثال، بالنسبة إلى إدخال مثل "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US"، قد تبدو الرموز المميّزة غير المحسَّنة على النحو التالي ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

يمثّل مكوّن عنوان، مثل شارع أو مدينة أو ولاية.

تمثيل JSON 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
الحقول
componentName

object (ComponentName)

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

string

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

enum (ConfirmationLevel)

يشير إلى مستوى التأكّد من صحة المكوّن.
inferred

boolean

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

boolean

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

boolean

يشير ذلك إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا، على سبيل المثال، استبدال رمز بريدي غير صحيح برمز صحيح للعنوان. هذا ليس تغييرًا جماليًا، بل تم تغيير مكوّن الإدخال إلى مكوّن مختلف.
unexpected

boolean

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

ComponentName

عنصر ملفوف لاسم المكوّن

تمثيل JSON 
{
  "text": string,
  "languageCode": string
}
الحقول
text

string

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

string

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

ConfirmationLevel

القيم المختلفة المحتمَلة لمستويات التأكيد

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

الرمز الجغرافي

يحتوي على معلومات عن المكان الذي تمّ ترميزه جغرافيًا.

تمثيل JSON 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
الحقول
location

object (LatLng)

الموقع الجغرافي المشفَّر جغرافيًا للبيانات المُدخلة.

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

object (PlusCode)

رمز Plus Codes المقابل للموقع الجغرافي location
bounds

object (Viewport)

حدود المكان الذي تم ترميزه جغرافيًا
featureSizeMeters

number

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

string

رقم تعريف المكان الذي يتم ترميزه جغرافيًا باستخدام هذا الإدخال.

لمزيد من المعلومات عن أرقام تعريف الأماكن، يُرجى الاطّلاع على هذا الرابط.
placeTypes[]

string

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

LatLng

عنصر يمثّل زوجًا من خطوط العرض/خطوط الطول ويتم التعبير عن ذلك كزوج من الأعداد المزدوجة لتمثيل درجات خط العرض ودرجات خط الطول. يجب أن يكون هذا العنصر متوافقًا مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن النطاقات العادية.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

number

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

PlusCode

رمز Plus Codes (http://plus.codes) هو مرجع موقع جغرافي يتضمّن تنسيقَين: رمز عالمي يحدّد مستطيلاً أصغر أو أكبر بقياس 14 مترًا في 14 مترًا (1/8000 من الدرجة)، ورمز مركب يستبدل البادئة بموقع جغرافي مرجعي.

تمثيل JSON 
{
  "globalCode": string,
  "compoundCode": string
}
الحقول
globalCode

string

الرمز العالمي (الكامل) للمكان، مثل "9FWM33GV+HQ"، الذي يمثّل منطقة بدرجة 1/8000 و1/8000 (حوالي 14 مترًا في 14 مترًا)
compoundCode

string

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

إطار العرض

إطار عرض لخطوط الطول والعرض، يتم تمثيله بنقطة low ونقطة high متعاكستين قطريًا يُعدّ إطار العرض منطقة مغلقة، أي أنّه يتضمّن حدوده. يجب أن تتراوح حدود خط العرض بين -90 و90 درجة، ويجب أن تتراوح حدود خط الطول بين -180 و180 درجة. تشمل الحالات المختلفة ما يلي:

  • إذا كان low = high، يتكوّن إطار العرض من تلك النقطة الواحدة.

  • إذا كان low.longitude > high.longitude، يتم عكس نطاق خط الطول (يمر إطار العرض بخط طول 180 درجة).

  • إذا كانت القيمة low.longitude = -180 درجة وhigh.longitude = 180 درجة، يتضمّن إطار العرض جميع خطوط الطول.

  • إذا كانت low.longitude = 180 درجة وhigh.longitude = -180 درجة، يكون نطاق خط الطول فارغًا.

  • إذا كان low.latitude > high.latitude، يكون نطاق خط الطول فارغًا.

يجب تعبئة كلٍّ من low وhigh، ولا يمكن أن يكون المربّع المعروض فارغًا (على النحو المحدّد في التعريفات أعلاه). سيؤدي استخدام مساحة عرض فارغة إلى حدوث خطأ.

على سبيل المثال، تحيط إطار العرض هذا بمدينة نيويورك بالكامل:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

تمثيل JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
الحقول
low

object (LatLng)

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

object (LatLng)

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

AddressMetadata

البيانات الوصفية للعنوان لا يمكن ضمان تعبئة الحقل metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.

تمثيل JSON 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
الحقول
business

boolean

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

boolean

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

boolean

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

UspsData

بيانات USPS للعنوان لا يمكن ضمان تعبئة الحقل uspsData بالكامل لكل عنوان في الولايات المتحدة أو في بورتوريكو يتم إرساله إلى Address Validation API. ننصحك بدمج حقول العنوان الاحتياطي في الاستجابة إذا كنت تستخدِم uspsData كجزء أساسي من الاستجابة.

تمثيل JSON 
{
  "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
}
الحقول
standardizedAddress

object (UspsAddress)

عنوان USPS الموحّد
deliveryPointCode

string

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

string

رقم التحقّق لنقطة التسليم تتم إضافة هذا الرقم إلى نهاية delivery_point_barcode للبريد الذي يتم فحصه آليًا. من المفترض أن تؤدي إضافة جميع أرقام delivery_point_barcode وdeliveryPointCheckDigit وpostal code وZIP+4 معًا إلى الحصول على رقم قابل للقسمة على 10.
dpvConfirmation

string

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

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

string

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

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

string

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

  • Y: العنوان هو عنوان بريد إلكتروني مخصّص للعملاء
  • N: العنوان ليس عنوانًا مخصّصًا لتلقّي الرسائل القصيرة في كاليفورنيا
dpvVacant

string

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

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

string

هل هذا عنوان لا يتضمّن إحصاءات أم عنوان نشط؟ إنّ العناوين غير المُسجَّلة هي العناوين التي لا يتمّ استخدامها بشكلٍ مستمر أو العناوين التي لا تخدمها خدمة USPS. لعرض حرف واحد.

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

integer

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

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

string

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

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

string

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

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

string

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

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

integer

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

string

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

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

string

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

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

string

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

  • Y: لا يمكن الوصول إلى الباب.
  • N: لا تتوفّر أي إشارة إلى أنّه لا يمكن الوصول إلى الباب.
dpvEnhancedDeliveryCode

string

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

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

string

رمز مسار مشغّل شبكة الجوّال رمز مكوّن من أربعة أحرف يتألف من بادئة مكوّنة من حرف واحد وثلاثة أحرف تدل على المسار

البوادئ:

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

string

مؤشر ترتيب تعرفات مسار شركة النقل
ewsNoMatch

boolean

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

string

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

string

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

string

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

string

رمز مقاطعة FIPS
county

string

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

string

رقم مسار الرحلة المحسّن (eLOT)
elotFlag

string

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

boolean

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

string

معرّف وحدة PMB (صندوق البريد الخاص)
pmbNumber

string

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

string

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

  • F: شركة هذه مطابقة لسجلّ شركة، وهو أعلى مستوى مطابقة متاح لعنوان.
  • G: التسليم العام هذه مطابقة لسجلّ التسليم العام.
  • ‫H: المبنى / الشقة هذه مطابقة لسجلّ مبنى أو شقة.
  • P: صندوق البريد هذا مطابق لصندوق البريد.
  • R: RURAL ROUTE أو HIGHWAY CONTRACT: تشير هذه السمة إلى تطابق مع سجلّ Rural Route أو Highway Contract، وكلاهما قد يتضمّن نطاقات مرتبطة بأرقام المربّعات.
  • S: سجلّ الشارع: تشير هذه الحالة إلى تطابق مع سجلّ شارع يحتوي على نطاق أرقام أساسي صالح.
defaultAddress

boolean

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

string

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

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

boolean

مؤشر يشير إلى أنّه تمت معالجة الطلب من خلال CASS

UspsAddress

تمثيل USPS لعنوان في الولايات المتحدة

تمثيل JSON 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
الحقول
firstAddressLine

string

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

string

اسم الشركة
secondAddressLine

string

سطر العنوان الثاني
urbanization

string

اسم منطقة حضرية في بورتوريكو.
cityStateZipAddressLine

string

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

string

اسم المدينة
state

string

رمز الولاية المكوّن من حرفَين
zipCode

string

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

string

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