فئة AddressValidation
google.maps.addressValidation.AddressValidation
صف
فئة ثابتة للوصول إلى واجهات برمجة التطبيقات الخاصة بخدمة "التحقّق من صحة العناوين"
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressValidation} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الطُرق الثابتة | |
|---|---|
fetchAddressValidation |
fetchAddressValidation(request)المَعلمات:
قيمة العائد:
Promise<AddressValidation>للتحقّق من صحة عنوان راجِع https://developers.google.com/maps/documentation/javascript/address-validation/validate-address. |
الخصائص | |
|---|---|
address |
النوع:
Address optionalتمثّل هذه السمة معلومات حول العنوان نفسه بدلاً من الرمز الجغرافي. |
geocode |
النوع:
Geocode optionalتمثّل هذه السمة معلومات حول الموقع الجغرافي والمكان اللذين تم ترميز العنوان جغرافيًا إليهما. |
metadata |
النوع:
AddressMetadata optionalمعلومات أخرى ذات صلة بإمكانية التسليم لا نضمن أن يتم ملء الحقل metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API. |
responseId |
النوع:
string optionalتمثّل هذه السمة المعرّف الفريد العالمي (UUID) الذي يحدّد هذه الاستجابة. إذا كان يجب إعادة التحقّق من صحة العنوان، يجب أن يكون رقم التعريف الفريد هذا مرفقًا بالطلب الجديد. |
uspsData |
النوع:
USPSData optionalعلامات إضافية لتحديد إمكانية التسليم تقدّمها خدمة البريد الأمريكية (USPS) يتم توفيرها في المنطقة US وPR فقط. |
verdict |
النوع:
Verdict optionalعلامات البيان العام |
الطُرق | |
|---|---|
toJSON |
toJSON()المَعلمات: بدون
قيمة العائد:
Objectتحويل فئة AddressValidation إلى عنصر JSON يتضمّن السمات نفسها |
AddressValidationRequest interface
google.maps.addressValidation.AddressValidationRequest
interface
واجهة الطلب الخاصة بـ AddressValidation.fetchAddressValidation
الخصائص | |
|---|---|
address |
النوع:
PostalAddressLiteralالعنوان الذي يتم التحقّق منه يجب إرسال العناوين غير المنسَّقة عبر PostalAddress.addressLines. |
placeAutocompleteElement optional |
النوع:
PlaceAutocompleteElement optionalفي حال استخدام PlaceAutocompleteElement، أدرِجه هنا لربط طلبات بيانات من واجهة AddressValidation API بالرمز المميز لجلسة الإكمال التلقائي. |
previousResponseId optional |
النوع:
string optionalيجب عدم ضبط هذا الحقل لطلب التحقّق الأول من صحة العنوان. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقّق من صحة عنوان واحد بشكل كامل (على سبيل المثال، إذا كانت التغييرات التي يجريها المستخدم بعد عملية التحقّق الأولية بحاجة إلى إعادة التحقّق)، يجب أن يملأ كل طلب متابعة هذا الحقل باستخدام AddressValidation.responseId من الرد الأول في تسلسل التحقّق. |
sessionToken optional |
النوع:
AutocompleteSessionToken optionalرمز مميّز يحدّد جلسة الإكمال التلقائي لأغراض الفوترة. |
uspsCASSEnabled optional |
النوع:
boolean optionalتفعيل وضع التوافق مع نظام CASS التابع لهيئة البريد الأمريكية يؤثّر ذلك فقط في الحقل AddressValidation.uspsData من AddressValidation. ملاحظة: بالنسبة إلى الطلبات التي تتضمّن عناوين في بورتوريكو والمفعَّلة في نظام CASS التابع لهيئة البريد الأمريكية، يجب تقديم PostalAddress.regionCode من address على النحو "PR"، أو يجب تقديم PostalAddress.administrativeArea من address على النحو "Puerto Rico" (غير حساسة لحالة الأحرف) أو "PR". |
Address class
google.maps.addressValidation.Address
صف
تفاصيل العنوان الذي تمت معالجته بعد الحصول عليه تشمل المعالجة اللاحقة تصحيح الأجزاء التي تحتوي على أخطاء إملائية في العنوان، واستبدال الأجزاء غير الصحيحة، واستنتاج الأجزاء الناقصة.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Address} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
components |
النوع:
Array<AddressComponent>مكوّنات العنوان الفردية للعنوان المنسَّق والمصحَّح، بالإضافة إلى معلومات التحقّق من الصحة تقدّم هذه السمة معلومات عن حالة التحقّق من صحة المكوّنات الفردية. |
formattedAddress |
النوع:
string optionalالعنوان الذي تمت معالجته بعد إدخاله، والذي تم تنسيقه كعنوان من سطر واحد باتّباع قواعد تنسيق العناوين في المنطقة التي يقع فيها العنوان |
missingComponentTypes |
النوع:
Array<string>أنواع المكوّنات التي كان من المتوقّع أن تكون متوفّرة في عنوان بريدي منسّق بشكلٍ صحيح ولكن لم يتم العثور عليها في الإدخال ولم يكن من الممكن استنتاجها. لا تتوفّر مكوّنات من هذا النوع في formatted_address أو postal_address أو address_components. على سبيل المثال، قد تكون القيمة ['street_number', 'route'] لمدخل مثل "Boulder, Colorado, 80301, USA". يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا. |
postalAddress |
النوع:
PostalAddress optionalالعنوان الذي تمت معالجته بعد إدخاله، ويتم تمثيله كعنوان بريدي. |
unconfirmedComponentTypes |
النوع:
Array<string>أنواع المكوّنات المتوفّرة في address_components ولكن تعذّر التأكّد من صحتها يتم توفير هذا الحقل لتسهيل الأمور: محتواه يعادل تكرار address_components للعثور على أنواع جميع المكوّنات التي لا تكون فيها قيمة AddressComponent.confirmationLevel هي ConfirmationLevel.CONFIRMED أو لم يتم ضبط العلامة AddressComponent.inferred على true. يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا. |
unresolvedTokens |
النوع:
Array<string>أي رموز مميّزة في الإدخال تعذّر حلّها قد يكون هذا الإدخال جزءًا غير صالح من العنوان (على سبيل المثال، في إدخال مثل "123235253253 Main St, San Francisco, CA, 94105"، قد تبدو الرموز المميزة التي لم يتم حلّها على النحو ["123235253253"] لأنّها لا تبدو كرقم شارع صالح. |
فئة AddressComponent
google.maps.addressValidation.AddressComponent
صف
تمثّل هذه السمة مكوّنًا واحدًا من العنوان (مثل اسم الشارع أو المدينة).
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressComponent} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
componentName |
النوع:
string optionalنص اسم المكوّن على سبيل المثال، "شارع 5" لاسم الشارع أو "1253" لرقم الشارع |
componentNameLanguageCode |
النوع:
string optionalتمثّل هذه السمة رمز اللغة المستخدَمة وفق المعيار BCP-47. لن يكون هذا الحقل متوفّرًا إذا لم يكن اسم المكوّن مرتبطًا بلغة، مثل رقم الشارع. |
componentType |
النوع:
string optionalتمثّل هذه السمة نوع مكوّن العنوان. راجِع الجدول 2: الأنواع الإضافية التي تعرضها خدمة "أماكن" للاطّلاع على قائمة بالأنواع المحتملة. |
confirmationLevel |
النوع:
ConfirmationLevel optionalتشير إلى مستوى التأكّد من صحة المكوّن. |
inferred |
النوع:
booleanإذا كانت القيمة صحيحة، يعني ذلك أنّ هذا المكوّن لم يكن جزءًا من الإدخال، ولكن تم استنتاجه لموقع العنوان. يُنصح بتضمين هذا المكوّن للحصول على عنوان كامل. |
replaced |
النوع:
booleanتشير إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا. على سبيل المثال، استبدال رمز بريدي خاطئ برمز بريدي صحيح للعنوان. هذا ليس تغييرًا شكليًا، بل تم تغيير مكوّن الإدخال إلى مكوّن مختلف. |
spellCorrected |
النوع:
booleanتشير إلى تصحيح خطأ إملائي في اسم المكوّن. لا تضع واجهة برمجة التطبيقات علامة دائمًا على التغييرات من صيغة كتابة إلى أخرى، مثل "centre" إلى "center". |
unexpected |
النوع:
booleanإذا كانت القيمة صحيحة، من غير المتوقّع أن يكون هذا المكوّن متوفّرًا في عنوان بريدي للمنطقة المحدّدة. تم الاحتفاظ به فقط لأنه كان جزءًا من المدخلات. |
فئة AddressMetadata
google.maps.addressValidation.AddressMetadata
صف
البيانات الوصفية الخاصة بالعنوان لا يمكن ضمان تعبئة AddressMetadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressMetadata} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
business |
النوع:
boolean |
poBox |
النوع:
boolean |
residential |
النوع:
boolean |
ConfirmationLevel الثوابت
google.maps.addressValidation.ConfirmationLevel
الثوابت
القيم المختلفة المحتملة التي تشير إلى مستوى اليقين بأنّ المكوّن صحيح.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
CONFIRMED |
|
UNCONFIRMED_AND_SUSPICIOUS |
|
UNCONFIRMED_BUT_PLAUSIBLE |
|
فئة الرمز الجغرافي
google.maps.addressValidation.Geocode
صف
يحتوي على معلومات حول المكان الذي تم ترميز الإدخال جغرافيًا إليه.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Geocode} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
bounds |
النوع:
LatLngBounds optionalتمثّل هذه السمة حدود المكان الذي تم ترميزه جغرافيًا. |
featureSizeMeters |
النوع:
number optionalحجم المكان الذي تم ترميزه جغرافيًا، بالأمتار هذا مقياس آخر لمدى دقة الموقع الجغرافي المرمّز، ولكن من حيث الحجم الفعلي وليس من حيث المعنى الدلالي. |
location |
النوع:
LatLngAltitude optionalالموقع الجغرافي المرمّز للإدخال |
placeId |
النوع:
string optionalرقم تعريف المكان الذي تم ترميزه جغرافيًا. يُفضّل استخدام Place على استخدام العناوين أو إحداثيات خطوط الطول والعرض أو رموز Plus Codes. سيؤدي استخدام الإحداثيات لتحديد المسار أو احتساب اتجاهات القيادة دائمًا إلى محاذاة النقطة مع الطريق الأقرب إلى هذه الإحداثيات. قد لا يكون هذا الطريق سريعًا أو آمنًا للوصول إلى الوجهة، وقد لا يكون بالقرب من نقطة وصول إلى المكان. بالإضافة إلى ذلك، عند تحويل الموقع الجغرافي إلى رمز جغرافي عكسي، لا يوجد ضمان بأنّ العنوان الذي تم عرضه سيتطابق مع العنوان الأصلي. |
placeTypes |
النوع:
Array<string>أنواع الأماكن التي تم تحويل الإدخال إلى ترميز جغرافي لها مثلاً: ['locality', 'political'] يمكنك الاطّلاع على القائمة الكاملة للأنواع في مستندات Geocoding API. |
plusCode |
النوع:
PlusCode optionalرمز Plus Codes المقابل لـ location |
الطُرق | |
|---|---|
fetchPlace |
fetchPlace()المَعلمات: بدون
القيمة المعروضة: لا شيء
تعرض هذه السمة تمثيلاً للمكان الخاص بهذا الرمز الجغرافي. للحصول على تفاصيل كاملة عن المكان، يجب إجراء طلب إلى place.fetchFields(). |
ثوابت الدقة
google.maps.addressValidation.Granularity
الثوابت
مستويات الدقة المختلفة التي يمكن أن يتضمّنها العنوان أو الرمز الجغرافي عند استخدامها للإشارة إلى مستوى الدقة الخاص بعنوان، تشير هذه القيم إلى مستوى الدقة الذي يحدّد به العنوان وجهة بريدية. على سبيل المثال، يشير عنوان مثل "123 شارع Main، مدينة Redwood، كاليفورنيا، 94061" إلى PREMISE، بينما يشير عنوان مثل "مدينة Redwood، كاليفورنيا، 94061" إلى LOCALITY. ومع ذلك، إذا تعذّر علينا العثور على رمز جغرافي للعنوان "123 Main Street" في مدينة ريدوود، قد يكون الرمز الجغرافي الذي يتم عرضه بدقة LOCALITY على الرغم من أنّ العنوان أكثر دقة.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Granularity} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
BLOCK |
يشير العنوان أو الرمز الجغرافي إلى مبنى سكني. تُستخدم فقط في المناطق التي تتضمّن عناوين على مستوى المبنى، مثل اليابان. |
OTHER |
جميع مستويات التفاصيل الأخرى، والتي يتم تجميعها معًا لأنّها غير قابلة للتسليم |
PREMISE |
نتيجة على مستوى المبنى |
PREMISE_PROXIMITY |
رمز جغرافي يقدّم تقريبًا الموقع الجغرافي للعنوان على مستوى المبنى |
ROUTE |
يكون الرمز الجغرافي أو العنوان دقيقًا بما يكفي لتحديد المسار، مثل شارع أو طريق أو طريق سريع. |
SUB_PREMISE |
نتيجة على مستوى أقل من المبنى، مثل شقة |
PossibleNextAction ثوابت
google.maps.addressValidation.PossibleNextAction
الثوابت
تقدّم ملخّصًا تفسيريًا لردّ واجهة برمجة التطبيقات، ويهدف إلى المساعدة في تحديد إجراء لاحق محتمل. هذا الحقل مشتقّ من حقول أخرى في استجابة واجهة برمجة التطبيقات (API)، ويجب عدم اعتباره ضمانًا لدقّة العنوان أو إمكانية تسليمه.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PossibleNextAction} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
ACCEPT |
لا تحتوي استجابة واجهة برمجة التطبيقات على إشارات تضمن إحدى قيم PossibleNextAction الأخرى. يمكنك التفكير في استخدام العنوان الذي تمت معالجته بعد ذلك بدون مطالبة العميل بإدخال المزيد من البيانات، ولكن هذا لا يضمن صحة العنوان، وقد يظل العنوان يتضمّن تصحيحات. وتقع على عاتقك مسؤولية تحديد ما إذا كان يجب أن تطلب من العميل تقديم معلومات إضافية وكيفية القيام بذلك، وذلك استنادًا إلى تقييم المخاطر الخاص بك. |
CONFIRM |
يشير حقل واحد أو أكثر من حقول استجابة واجهة برمجة التطبيقات إلى مشاكل بسيطة محتملة في العنوان الذي تمت معالجته بعد إرساله، مثل أنّ مكوّن العنوان postal_code كان replaced. قد يساعد الطلب من العميل مراجعة العنوان في تحسين جودته. |
CONFIRM_ADD_SUBPREMISES |
تشير استجابة واجهة برمجة التطبيقات إلى أنّ العنوان الذي تمت معالجته لاحقًا قد لا يتضمّن مبنى فرعيًا. يمكن أن يساعد حثّ العميل على مراجعة العنوان والتفكير في إضافة رقم الوحدة في تحسين جودة العنوان. قد يتضمّن العنوان الذي تمت معالجته لاحقًا مشاكل بسيطة أخرى. ملاحظة: لا يمكن عرض قيمة التعداد هذه إلا لعناوين الولايات المتحدة. |
FIX |
يشير حقل واحد أو أكثر من حقول استجابة واجهة برمجة التطبيقات إلى مشكلة محتملة في العنوان الذي تمت معالجته بعد إرساله، على سبيل المثال، verdict.validation_granularity هو OTHER. قد يساعد الطلب من العميل تعديل العنوان في تحسين جودة العنوان. |
فئة USPSAddress
google.maps.addressValidation.USPSAddress
صف
تمثيل USPS لعنوان في الولايات المتحدة
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {USPSAddress} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
city |
النوع:
string optionalاسم المدينة |
cityStateZipAddressLine |
النوع:
string optionalسطر العنوان الذي يتضمّن المدينة والولاية والرمز البريدي |
firm |
النوع:
string optionalاسم الشركة |
firstAddressLine |
النوع:
string optionalالسطر الأول من العنوان |
secondAddressLine |
النوع:
string optionalتمثّل هذه السمة السطر الثاني من العنوان. |
state |
النوع:
string optionalتمثّل هذه السمة رمز الولاية المكوَّن من حرفين. |
urbanization |
النوع:
string optionalتمثّل هذه السمة اسم المنطقة الحضرية في بورتوريكو. |
zipCode |
النوع:
string optionalالرمز البريدي، مثل "10009" |
zipCodeExtension |
النوع:
string optionalإضافة الرمز البريدي المكوّن من 4 أرقام، مثل "5023" |
USPSData
google.maps.addressValidation.USPSData
صف
تمثّل هذه السمة بيانات هيئة البريد الأمريكية (USPS) الخاصة بالعنوان. لا يمكن ضمان ملء حقل USPSData بالكامل لكل عنوان في الولايات المتحدة أو بورتوريكو يتم إرساله إلى Address Validation API. ننصحك بدمج حقول العنوان الاحتياطي في الردّ إذا كنت تستخدم uspsData كالجزء الأساسي من الردّ.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {USPSData} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
abbreviatedCity |
النوع:
string optionalالمدينة المختصَرة |
addressRecordType |
النوع:
string optionalنوع سجلّ العنوان الذي يتطابق مع العنوان المُدخَل. |
carrierRoute |
النوع:
string optionalتمثّل هذه السمة رمز مسار مشغّل شبكة الجوّال. رمز مكوّن من أربعة أحرف ويتألف من بادئة من حرف واحد ومحدّد مسار مكوّن من ثلاثة أرقام. |
carrierRouteIndicator |
النوع:
string optionalمؤشر ترتيب أسعار مسارات شركات النقل |
cassProcessed |
النوع:
booleanمؤشر على أنّه تمت معالجة الطلب باستخدام نظام CASS. |
county |
النوع:
string optionalاسم المقاطعة |
deliveryPointCheckDigit |
النوع:
string optionalرقم التحقّق الخاص بنقطة التسليم يُضاف هذا الرقم إلى نهاية الرمز الشريطي لنقطة التسليم الخاص بالبريد الذي يتم مسحه ضوئيًا آليًا. يجب أن يؤدي جمع كل أرقام delivery_point_barcode وdelivery_point_check_digit والرمز البريدي وZIP+4 إلى الحصول على رقم قابل للقسمة على 10. |
deliveryPointCode |
النوع:
string optionalتمثّل هذه السمة رمز نقطة التسليم المكوّن من رقمَين. |
dpvCMRA |
النوع:
string optionalتشير إلى ما إذا كان العنوان هو وكالة استلام البريد التجاري (CMRA)، وهي مؤسسة خاصة تستلم البريد نيابةً عن العملاء. لعرض حرف واحد. |
dpvConfirmation |
النوع:
string optionalالقيم المحتملة لتأكيد DPV تعرض هذه الدالة حرفًا واحدًا أو لا تعرض أي قيمة. |
dpvDoorNotAccessible |
النوع:
string optionalتشير العلامة إلى العناوين التي لا يمكن فيها لمصلحة البريد الأمريكية (USPS) طرق الباب لتسليم البريد. لعرض حرف واحد. |
dpvDrop |
النوع:
string optionalيشير العلم إلى أنّه يتم تسليم البريد إلى صندوق واحد في الموقع. لعرض حرف واحد. |
dpvEnhancedDeliveryCode |
النوع:
string optionalتشير إلى أنّ هناك أكثر من رمز إرجاع DPV صالح للعنوان. لعرض حرف واحد. |
dpvFootnote |
النوع:
string optionalالحواشي السفلية من عملية التحقّق من نقطة التسليم يمكن ربط حواشٍ سفلية متعددة في السلسلة نفسها. |
dpvNonDeliveryDays |
النوع:
string optionalتشير العلامة إلى أنّه لا يتم تسليم البريد كل يوم من أيام الأسبوع. لعرض حرف واحد. |
dpvNonDeliveryDaysValues |
النوع:
number optionalعدد صحيح يحدّد أيام عدم التسليم. يمكن الاستعلام عنه باستخدام علامات البت: 0x40 – الأحد هو يوم لا يتم فيه التسليم 0x20 – الاثنين هو يوم لا يتم فيه التسليم 0x10 – الثلاثاء هو يوم لا يتم فيه التسليم 0x08 – الأربعاء هو يوم لا يتم فيه التسليم 0x04 – الخميس هو يوم لا يتم فيه التسليم 0x02 – الجمعة هو يوم لا يتم فيه التسليم 0x01 – السبت هو يوم لا يتم فيه التسليم |
dpvNoSecureLocation |
النوع:
string optionalتشير العلامة إلى أنّه يمكن الوصول إلى الباب، ولكن لن يتم ترك الحزمة بسبب مخاوف أمنية. لعرض حرف واحد. |
dpvNoStat |
النوع:
string optionalتشير إلى ما إذا كان العنوان لا يتضمّن إحصاءات أو كان عنوانًا نشطًا. لا يمكن استخدام عناوين إحصائية غير مشغولة باستمرار أو عناوين لا تقدّم هيئة البريد الأمريكية خدماتها إليها. لعرض حرف واحد. |
dpvNoStatReasonCode |
النوع:
number optionalيشير إلى نوع NoStat. تعرض هذه السمة رمز السبب كعدد صحيح. |
dpvPBSA |
النوع:
string optionalيشير إلى أنّه تمّت مطابقة العنوان مع سجلّ PBSA. لعرض حرف واحد. |
dpvThrowback |
النوع:
string optionalتشير إلى أنّه لا يتم تسليم البريد إلى عنوان الشارع. لعرض حرف واحد. |
dpvVacant |
النوع:
string optionalتشير إلى ما إذا كان العنوان شاغرًا. لعرض حرف واحد. |
elotFlag |
النوع:
string optionalعلامة ترتيب الأولوية الإلكترونية تصاعديًا/تنازليًا (A/D) |
elotNumber |
النوع:
string optionalرقم "خط السير المحسّن" (eLOT) |
errorMessage |
النوع:
string optionalرسالة خطأ بشأن استرداد بيانات USPS يتم ملء هذا الحقل عند تعليق معالجة USPS بسبب رصد عناوين تم إنشاؤها بشكل مصطنع. |
fipsCountyCode |
النوع:
string optionalرمز FIPS للمقاطعة |
hasDefaultAddress |
النوع:
booleanمؤشر على أنّه تم العثور على عنوان تلقائي، ولكن توجد عناوين أكثر تحديدًا. |
hasNoEWSMatch |
النوع:
booleanيمكن مطابقة عنوان التسليم، ولكن يشير ملف EWS إلى أنّ المطابقة التامة ستتوفّر قريبًا. |
lacsLinkIndicator |
النوع:
string optionalمؤشر LACSLink |
lacsLinkReturnCode |
النوع:
string optionalرمز الإرجاع LACSLink |
pmbDesignator |
النوع:
string optionalمعرّف وحدة صندوق البريد الخاص (PMB) |
pmbNumber |
النوع:
string optionalرقم صندوق البريد الخاص (PMB) |
poBoxOnlyPostalCode |
النوع:
booleanالرمز البريدي الخاص بصندوق البريد فقط |
postOfficeCity |
النوع:
string optionalتمثّل هذه السمة المدينة التي يقع فيها مكتب البريد الرئيسي. |
postOfficeState |
النوع:
string optionalتمثّل هذه السمة الولاية التي يقع فيها مكتب البريد الرئيسي. |
standardizedAddress |
النوع:
USPSAddress optionalعنوان موحّد لدى USPS |
suiteLinkFootnote |
النوع:
string optionalحواشٍ سفلية من مطابقة سجلّ شارع أو مبنى مرتفع مع معلومات الجناح في حال العثور على تطابق في اسم المؤسسة، يتم عرض الرقم الثانوي. |
Verdict class
google.maps.addressValidation.Verdict
صف
تمثّل هذه السمة العنوان الذي تمت معالجته بعد إدخاله.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Verdict} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
addressComplete |
النوع:
booleanيُعدّ العنوان مكتملاً إذا لم تكن هناك رموز غير محلولة، ولم تكن هناك مكوّنات عنوان غير متوقّعة أو مفقودة. إذا لم يتم ضبطها، يشير ذلك إلى أنّ القيمة هي false. يُرجى الاطّلاع على الحقول Address.missingComponentTypes أو Address.unresolvedTokens أو AddressComponent.unexpected لمزيد من التفاصيل. |
geocodeGranularity |
النوع:
Granularity optionalمعلومات حول درجة دقة Geocode يمكن فهم ذلك على أنّه المعنى الدلالي لمدى دقة الموقع الجغرافي المرمّز جغرافيًا. |
hasInferredComponents |
النوع:
booleanتم استنتاج (أي إضافة) مكوّن عنوان واحد على الأقل لم يكن في الإدخال، راجِع AddressComponent للاطّلاع على التفاصيل. |
hasReplacedComponents |
النوع:
boolean optionalتم استبدال مكوّن عنوان واحد على الأقل، راجِع AddressComponent للحصول على التفاصيل. |
hasUnconfirmedComponents |
النوع:
booleanلا يمكن تصنيف مكوّن عنوان واحد على الأقل أو التحقّق من صحته، راجِع AddressComponent للحصول على التفاصيل. |
inputGranularity |
النوع:
Granularity optionalمستوى تفصيل عنوان الإدخال هذه هي نتيجة تحليل العنوان المُدخَل ولا تقدّم أي إشارات للتحقّق من صحته. للحصول على إشارات التحقّق، يُرجى الرجوع إلى validationGranularity. |
possibleNextAction |
النوع:
PossibleNextAction optionalإجراء محتمل يمكن اتّخاذه استنادًا إلى الحقول الأخرى في استجابة واجهة برمجة التطبيقات ولمزيد من التفاصيل، يمكنك الاطّلاع على PossibleNextAction. |
validationGranularity |
النوع:
Granularity optionalمستوى التفاصيل الذي يمكن لواجهة برمجة التطبيقات التحقّق من صحة العنوان بالكامل. على سبيل المثال، يشير validationGranularity بقيمة PREMISE إلى أنّه يمكن التحقّق من صحة جميع مكوّنات العنوان على مستوى PREMISE والمستويات الأوسع. |