- طلب HTTP
- نص الطلب
- نص الاستجابة
- PostalAddress
- التحقّق من صحة النتيجة
- الحكم
- الدقة
- العنوان
- AddressComponent
- ComponentName
- ConfirmationLevel
- الرمز الجغرافي
- خط الطول والعرض
- رمز Plus Codes
- إطار العرض
- البيانات الوصفية للعنوان
- UspsData
- UspsAddress
للتحقق من صحة عنوان.
طلب HTTP
POST https://addressvalidation.googleapis.com/v1:validateAddress
يستخدم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"address": {
object ( |
الحقول | |
---|---|
address |
مطلوبة. جارٍ التحقق من العنوان. يجب إرسال العناوين غير المنسقة عبر يجب ألا يتجاوز إجمالي طول الحقول في هذا الإدخال 280 حرفًا. يمكن العثور على المناطق المتوافقة في الأسئلة الشائعة. القيمة تتجاهل واجهة برمجة تطبيقات التحقق من العنوان القيم في |
previousResponseId |
يجب أن يكون هذا الحقل فارغًا لطلب التحقق من العنوان الأول. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقق من صحة عنوان واحد بشكل كامل (على سبيل المثال، إذا كان يلزم إعادة التحقق من التغييرات التي أجراها المستخدم بعد التحقق الأولي)، يجب أن يملأ كل طلب متابعة هذا الحقل بـ |
enableUspsCass |
لتمكين وضع التوافق مع USPS CASS. ويؤثر هذا الإجراء في الحقل يوصى باستخدام |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الاستجابة لطلب التحقق من العنوان.
تمثيل JSON |
---|
{
"result": {
object ( |
الحقول | |
---|---|
result |
نتيجة التحقق من العنوان. |
responseId |
المعرّف الفريد العالمي (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 |
مراجعة مخطط |
regionCode |
اختياريّ. رمز منطقة CLDR للبلد/المنطقة للعنوان. راجع https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html للحصول على التفاصيل. مثال: "CH" لسويسرا. إذا لم يتم تقديم رمز المنطقة، سيتم استنتاجه من العنوان. للحصول على أفضل أداء، ننصح بتضمين رمز المنطقة إذا كنت تعرفه. قد يؤدي عدم اتساق المناطق أو تكرارها إلى ضعف الأداء، على سبيل المثال، إذا كان |
languageCode |
رمز اللغة في عنوان الإدخال محجوز للاستخدامات المستقبلية ويتم تجاهله اليوم. تعرض واجهة برمجة التطبيقات العنوان باللغة المناسبة للمكان الذي يقع فيه العنوان. |
postalCode |
اختياريّ. الرمز البريدي للعنوان. لا تستخدم جميع البلدان الرموز البريدية أو تتطلّب وجودها، ولكنها قد تؤدي إلى إجراء عملية تحقّق إضافية في أجزاء أخرى من العنوان في أماكن استخدامها (على سبيل المثال، التحقّق من الولاية/الرمز البريدي في الولايات المتحدة الأمريكية). |
sortingCode |
اختياريّ. شفرة تصنيف إضافية خاصة بكل بلد. ولا يتم استخدام هذا الرقم في معظم المناطق. حيثما يتم استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة اختياريًا برقم (على سبيل المثال "CEDEX 7")، أو رقم فقط، الذي يمثل "رمز القطاع" (جامايكا)، أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال، ساحل العاج). |
administrativeArea |
اختياريّ. أعلى قسم فرعي إداري يستخدم للعناوين البريدية لبلد أو منطقة. على سبيل المثال: يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، إسبانيا هي الإقليم وليس المجتمع الذاتي (مثل "برشلونة" وليس "كتالونيا"). لا تستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، يجب عدم تعبئة هذا الحقل في سويسرا. |
locality |
اختياريّ. تشير عمومًا إلى جزء المدينة/البلدة من العنوان. أمثلة: مدينة أمريكية، بلدية تكنولوجيا المعلومات، بلدة بريدية بالمملكة المتحدة. في مناطق العالم التي لم يتم تعريف المناطق المحلية فيها بشكل جيد أو التي لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines. |
sublocality |
اختياريّ. المنطقة الفرعية للعنوان. على سبيل المثال: يمكن أن يتمثل ذلك في أحياء، أحياء، مقاطعات. |
addressLines[] |
مطلوبة. أسطر عنوان غير منظمة تصف المستويات الأدنى للعنوان. |
recipients[] |
يُرجى تجنب تعيين هذا الحقل. ولا تستخدمها "واجهة برمجة التطبيقات للتحقق من صحة العنوان" حاليًا. على الرغم من أن واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات ذات مجموعة الحقول هذه، إلا أنه سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة. |
organization |
يُرجى تجنب تعيين هذا الحقل. ولا تستخدمها "واجهة برمجة التطبيقات للتحقق من صحة العنوان" حاليًا. على الرغم من أن واجهة برمجة التطبيقات لن ترفض في الوقت الحالي الطلبات ذات مجموعة الحقول هذه، إلا أنه سيتم تجاهل المعلومات ولن يتم عرضها في الاستجابة. |
نتيجة التحقق
نتيجة التحقق من صحة العنوان.
تمثيل JSON |
---|
{ "verdict": { object ( |
الحقول | |
---|---|
verdict |
علامات القرار العام |
address |
معلومات حول العنوان نفسه على عكس الترميز الجغرافي |
geocode |
معلومات حول الموقع والمكان اللذين تم ترميزهما جغرافيًا بالعنوان. |
metadata |
معلومات أخرى ذات صلة بالتسليم. لا يمكن ضمان تعبئة |
uspsData |
علامات إضافية للتسليم توفّرها USPS. يتوفّر فقط في المنطقة |
النتيجة
نظرة عامة عالية المستوى على نتيجة التحقق من العنوان والشكل الجغرافي.
تمثيل JSON |
---|
{ "inputGranularity": enum ( |
الحقول | |
---|---|
inputGranularity |
دقة عنوان الإدخال. ويحدث ذلك نتيجة تحليل عنوان الإدخال ولا يعطي أي إشارات تحقُّق. للحصول على إشارات التحقق، يمكنك الرجوع إلى على سبيل المثال، إذا كان عنوان الإدخال يتضمّن رقم شقة معيّنًا، سيكون |
validationGranularity |
مستوى الدقة الذي يمكن لواجهة برمجة التطبيقات التحقق من العنوان بالكامل إليه. على سبيل المثال، يشير يمكن العثور على نتيجة التحقق من صحة مكونات كل عنوان في |
geocodeGranularity |
معلومات عن دقة وقد يختلف هذا عن |
addressComplete |
يُعتبر العنوان مكتملاً إذا لم تكن هناك رموز مميزة لم تُحَل، ولم تكن هناك مكونات عنوان غير متوقعة أو مفقودة. يمكنك الاطّلاع على الحقول |
hasUnconfirmedComponents |
يتعذّر تصنيف مكوّن عنوان واحد على الأقل أو التحقّق من صحته. يمكنك الاطّلاع على |
hasInferredComponents |
تم استنتاج (إضافة) مكوِّن عنوان واحد على الأقل لم يتم إدخاله، يُرجى الاطّلاع على |
hasReplacedComponents |
تم استبدال مكون عنوان واحد على الأقل، اطّلع على |
الدقة
درجات الدقة المختلفة التي يمكن أن يحتوي عليها العنوان أو الترميز الجغرافي. عند استخدامها للإشارة إلى الدقة في العنوان، تشير هذه القيم إلى مدى دقة التفاصيل التي يحدِّدها العنوان لوجهة بريدية. على سبيل المثال، يحدّد عنوان مثل "123 Main Street, Redwood City, CA, 94061" PREMISE
بينما يحدّد عنصر مثل "Redwood City, CA, 94061" LOCALITY
. ومع ذلك، إذا لم نتمكّن من العثور على رمز جغرافي لـ "123 Main Street" في "ريدوود سيتي"، قد يكون الترميز الجغرافي المعروض دقيقًا بنسبة LOCALITY
على الرغم من أن العنوان أكثر دقة.
عمليات التعداد | |
---|---|
GRANULARITY_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدَمة. |
SUB_PREMISE |
نتيجة تحت مستوى المبنى، مثل شقة. |
PREMISE |
نتيجة على مستوى المبنى. |
PREMISE_PROXIMITY |
رمز جغرافي يجب أن يكون قريبًا جدًا من موقع العنوان على مستوى المبنى. يُستخدم فقط للرموز الجغرافية وليس للعناوين. |
BLOCK |
يشير العنوان أو الشكل الجغرافي إلى وجود حظر. يُستخدم فقط في المناطق التي لديها عناوين على مستوى الحظر، مثل اليابان. |
ROUTE |
يكون الموقع الجغرافي أو العنوان دقيقًا في المسار، مثل الشارع أو الطريق أو الطريق السريعة. |
OTHER |
جميع درجات الدقة الأخرى، والتي يتم تجميعها معًا نظرًا لعدم إمكانية تسليمها. |
العنوان
تفاصيل العنوان الذي تم تحليله من الإدخال.
تمثيل JSON |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
الحقول | |
---|---|
formattedAddress |
العنوان الذي تم تصحيحه، بالتنسيق في سطر واحد مع اتباع قواعد تنسيق العنوان للمنطقة التي يقع فيها العنوان. |
postalAddress |
العنوان الذي تم التحقق من صحته والممثّل كعنوان بريدي. |
addressComponents[] |
قائمة بدون ترتيب. مكونات العنوان الفردي للعنوان الذي تم تنسيقه والتصحيح، بالإضافة إلى معلومات التحقق. يقدم هذا معلومات حول حالة التحقق للمكونات الفردية. لم يتم ترتيب مكوّنات العنوان بطريقة معينة. لا تقدم أي افتراضات حول ترتيب مكونات العنوان في القائمة. |
missingComponentTypes[] |
أنواع المكوّنات التي كان من المتوقع وجودها في عنوان بريدي منسق بشكل صحيح ولكن لم يتم العثور عليها في الإدخال وتعذر استنتاجها. لا توجد مكوّنات من هذا النوع في |
unconfirmedComponentTypes[] |
أنواع المكوّنات الموجودة في |
unresolvedTokens[] |
أي رموز مميزة في الإدخال لم يتم حلها. قد يكون هذا إدخالاً لم يتم التعرف عليه باعتباره جزءًا صالحًا من أحد العناوين (على سبيل المثال، في إدخال مثل "123235253253 الشارع الرئيسي، سان فرانسيسكو، كاليفورنيا، 94105"، قد تبدو الرموز المميزة التي لم يتم حلها كـ |
مكوّن العنوان
يمثل مكون عنوان، مثل شارع أو مدينة أو ولاية.
تمثيل JSON |
---|
{ "componentName": { object ( |
الحقول | |
---|---|
componentName |
اسم هذا المكوِّن. |
componentType |
نوع مكوّن العنوان. راجع الجدول 2: الأنواع الإضافية التي تعرضها خدمة الأماكن للحصول على قائمة بالأنواع المحتملة. |
confirmationLevel |
يشير إلى مستوى اليقين الذي لدينا للتأكد من أن المكون صحيح. |
inferred |
يشير إلى أن المكون لم يكن جزءًا من الإدخال، ولكننا استنتجنا أنه لموقع العنوان ونعتقد أنه يجب أن يتم تقديمه لعنوان كامل. |
spellCorrected |
تشير هذه السمة إلى تصحيح هجاء اسم المكوّن بطريقة بسيطة، على سبيل المثال من خلال تبديل حرفين ظهرا بترتيب غير صحيح. ويشير هذا إلى تغيير شكلي. |
replaced |
يشير إلى أنه تم استبدال اسم المكوِّن برمز آخر مختلف تمامًا، على سبيل المثال تم استبدال رمز بريدي غير صحيح بأخرى صحيحة للعنوان. هذا ليس تغييرًا تجميليًا، لقد تم تغيير مكوِّن الإدخال إلى مكوِّن آخر. |
unexpected |
تشير إلى مكون عنوان ليس من المتوقع وجوده في عنوان بريدي للمنطقة المحددة. وقد تم الاحتفاظ بها فقط لأنها كانت جزءًا من الإدخال. |
اسم المكوّن
برنامج تضمين لاسم المكوِّن.
تمثيل JSON |
---|
{ "text": string, "languageCode": string } |
الحقول | |
---|---|
text |
نص الاسم. على سبيل المثال، "الشارع الخامس" لاسم الشارع أو "1253" لرقم الشارع. |
languageCode |
تمثّل هذه الخاصية رمز اللغة BCP-47. لن يتوفر هذا إذا لم يكن اسم المكون مقترنًا بإحدى اللغات، مثل رقم الشارع. |
مستوى التأكيد
القيم المحتملة المختلفة لمستويات التأكيد.
عمليات التعداد | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدَمة. |
CONFIRMED |
لقد تحققنا من وجود هذا المكوّن ومن المنطقي في سياق بقية العنوان. |
UNCONFIRMED_BUT_PLAUSIBLE |
تعذر التأكد من هذا المكون، ولكن من الممكن وجوده. على سبيل المثال، رقم شارع يقع ضمن نطاق صالح من الأرقام في أحد الشوارع حيث تكون أرقام منازل معينة غير معروفة. |
UNCONFIRMED_AND_SUSPICIOUS |
لم يتم تأكيد هذا المكوّن ومن المحتمل أن يكون غير صحيح. على سبيل المثال، حي لا يتناسب مع بقية العنوان. |
ترميز جغرافي
يحتوي على معلومات حول المكان الذي تم ترميز الإدخال فيه جغرافيًا.
تمثيل JSON |
---|
{ "location": { object ( |
الحقول | |
---|---|
location |
موقع الإدخال الجغرافي جغرافيًا. يُفضل استخدام أرقام تعريف الأماكن على استخدام العناوين، أو إحداثيات خطوط الطول/خطوط العرض، أو رموز المواقع المفتوحة. استخدام إحداثيات عند توجيه أو حساب اتجاهات القيادة يؤدي دائمًا إلى الانقطاع إلى الطريق الأقرب إلى هذه الإحداثيات. قد لا يكون هذا طريقًا يؤدي سريعًا أو بأمان إلى الوجهة وقد لا يكون بالقرب من نقطة دخول إلى العقار. بالإضافة إلى ذلك، عندما يكون هناك موقع جغرافي تم عكسه جغرافيًا، لا يوجد ما يضمن تطابق العنوان المعروض مع العنوان الأصلي. |
plusCode |
رمز الموقع المفتوح المقابل لـ |
bounds |
حدود المكان الذي تم ترميزه جغرافيًا. |
featureSizeMeters |
حجم المكان الجغرافي، بالأمتار. وهذا قياس آخر لمدى تقارب الموقع الجغرافي الذي تم ترميزه جغرافيًا، ولكنه بالحجم الفعلي بدلاً من المعنى الدلالي. |
placeId |
معرّف المكان للمكان الذي تم إدخال إدخال جغرافي له. ولمزيد من المعلومات عن أرقام تعريف الأماكن، اطّلع على هذه الصفحة. |
placeTypes[] |
تمثل هذه الخاصية أنواع الأماكن التي تمّ إدخال ترميز جغرافي لها. مثلاً: |
خط الطول والعرض
كائن يمثل زوج خط العرض/خط الطول. يتم التعبير عن هذا كزوج من زوجي لتمثيل الدرجات خط الطول وخط الدرجات بالدرجات. يجب أن يتوافق هذا الكائن مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم داخل نطاقات تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
خط العرض بالدرجات. ويجب أن يقع ضمن النطاق [-90.0 أو +90.0]. |
longitude |
خط الطول بالدرجات. ويجب أن تقع ضمن النطاق [-180.0، +180.0]. |
رمز الموقع المفتوح
رمز الموقع المفتوح (http://plus.codes) هو مرجع موقع بتنسيقين: رمز عام يحدد 14mx14m (1/8000th of a degrees) أو مستطيل صغير، ورمزًا مركبًا، ويستبدل البادئة بموقع مرجعي.
تمثيل JSON |
---|
{ "globalCode": string, "compoundCode": string } |
الحقول | |
---|---|
globalCode |
رمز المكان العالمي (الكامل)، مثل "9FWM33GV+HQ"، الذي يمثل مساحة قدرها 1/8000 x 1/8000 درجة (14 × 14 مترًا تقريبًا). |
compoundCode |
الرمز المركّب للمكان، مثل "33GV+HQ, Ramberg, Norway"، ويحتوي على لاحقة الرمز العام واستبدال البادئة باسم منسق للكيان المرجعي. |
إطار العرض
إطار العرض لخط العرض، ويتم تمثيله كنقطتين متعاكستين لـ 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 ( |
الحقول | |
---|---|
low |
مطلوبة. نقطة العرض المنخفضة لإطار العرض. |
high |
مطلوبة. نقطة ارتفاع إطار العرض. |
بيانات وصفية للعنوان
البيانات الوصفية للعنوان لا يمكن ضمان تعبئة metadata
بالكامل لكل عنوان يتم إرساله إلى واجهة برمجة تطبيقات "التحقّق من العنوان".
تمثيل JSON |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
الحقول | |
---|---|
business |
يشير إلى أن هذا هو عنوان النشاط التجاري. في حال ترك السياسة بدون ضبط، يشير ذلك إلى أن القيمة غير معروفة. |
poBox |
يشير إلى أنّ عنوان صندوق البريد في حال ترك السياسة بدون ضبط، يشير ذلك إلى أن القيمة غير معروفة. |
residential |
يشير إلى أن هذا هو عنوان الإقامة. في حال ترك السياسة بدون ضبط، يشير ذلك إلى أن القيمة غير معروفة. |
بيانات USps
بيانات USPS للعنوان. لا يمكن ضمان تعبئة uspsData
بالكامل لكل عنوان في الولايات المتحدة أو أي قسم علاقات عامة يتم إرساله إلى واجهة برمجة تطبيقات التحقق من العنوان. يُوصى بدمج حقول العنوان الاحتياطي في الاستجابة إذا كنت تستخدم uspsData كجزء أساسي من الاستجابة.
تمثيل JSON |
---|
{
"standardizedAddress": {
object ( |
الحقول | |
---|---|
standardizedAddress |
عنوان USPS القياسي. |
deliveryPointCode |
رمز نقطة التسليم المكوّن من رقمين |
deliveryPointCheckDigit |
رقم التحقق من نقطة التسليم تتم إضافة هذا الرقم إلى نهاية رمز التسليم_الشريطي_للبريد الذي تم مسحه ضوئيًا بشكل ميكانيكي. من المفترض أن تؤدي إضافة جميع الأرقام لـ delivery_point_barcode وdeliveryPointCheckDigit والرمز البريدي والرمز البريدي+4 معًا إلى الحصول على رقم قابل للقسمة على 10. |
dpvConfirmation |
القيم المحتملة لتأكيد DPV لعرض حرف واحد.
|
dpvFootnote |
الحواشي السفلية من التحقق من نقطة التسليم. قد يتم ربط الحواشي السفلية المتعددة معًا في السلسلة نفسها.
|
dpvCmra |
يشير إلى ما إذا كان العنوان هو هيئة CMRA (وكالة تلقي رسائل تجارية) - نشاط تجاري خاص يتلقى البريد للعملاء. لعرض حرف واحد.
|
dpvVacant |
هل هذا المكان شاغر؟ لعرض حرف واحد.
|
dpvNoStat |
هل هذا العنوان لا يتضمن إحصاءات إحصائية أو عنوانًا نشطًا؟ لا توجد عناوين إحصاءات هي تلك التي لا يتم شغلها بشكل مستمر أو العناوين التي لا يقدمها USPS. لعرض حرف واحد.
|
carrierRoute |
رمز مسار شركة النقل. رمز مكون من أربعة أحرف يتكون من بادئة من حرف واحد ومصمم مسار من ثلاثة أرقام. البادئات:
|
carrierRouteIndicator |
مؤشر ترتيب معدّل مسار شركة النقل |
ewsNoMatch |
عنوان التسليم متطابق، ولكن يشير ملف EWS إلى أن هناك تطابقًا تامًا سيكون متاحًا قريبًا. |
postOfficeCity |
مدينة مكتب البريد الرئيسية. |
postOfficeState |
الولاية الرئيسية لمكتب البريد. |
abbreviatedCity |
مدينة مختصرة. |
fipsCountyCode |
رمز مقاطعة FIPS. |
county |
اسم المقاطعة. |
elotNumber |
رقم خط السفر المحسن (eLOT). |
elotFlag |
علامة eLOT تصاعدي/تنازلي (أ/د). |
lacsLinkReturnCode |
رمز إرجاع LACSLink. |
lacsLinkIndicator |
مؤشر LACSLink. |
poBoxOnlyPostalCode |
الرمز البريدي لصندوق البريد فقط. |
suitelinkFootnote |
الحواشي السفلية من مطابقة شارع أو سجل في صعود المبنى إلى معلومات الجناح. وفي حال العثور على مطابقة لاسم النشاط التجاري، يتم عرض الرقم الثانوي.
|
pmbDesignator |
محدد وحدة (PMB) (البريد الخاص). |
pmbNumber |
رقم PMB (صندوق البريد الخاص)؛ |
addressRecordType |
نوع سجل العنوان الذي يتطابق مع عنوان الإدخال.
|
defaultAddress |
إشارة إلى أنه تم العثور على عنوان تلقائي، ولكن هناك عناوين أكثر تحديدًا. |
errorMessage |
رسالة خطأ استرداد بيانات USPS. تتمّ تعبئة هذا الحقل عندما يتمّ تعليق معالجة USPS بسبب رصد عناوين تمّ إنشاؤها بطريقة مصطنعة. قد لا تتم تعبئة حقول بيانات USPS عند وجود هذا الخطأ. |
cassProcessed |
مؤشر على أنه قد تمت معالجة طلب CAS. |
عنوان USps
تمثيل USPS لعنوان في الولايات المتحدة.
تمثيل JSON |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
الحقول | |
---|---|
firstAddressLine |
السطر الأول من العنوان. |
firm |
اسم الشركة. |
secondAddressLine |
السطر الثاني من العنوان. |
urbanization |
اسم المنطقة الحضرية في بورتوريكو. |
cityStateZipAddressLine |
المدينة + الولاية + الرمز البريدي. |
city |
اسم المدينة. |
state |
رمز حالة مكوّن من حرفين. |
zipCode |
الرمز البريدي مثل 10009. |
zipCodeExtension |
إضافة رمز بريدي مكوّنة من 4 أرقام، مثل 5023. |