Address Validation (beta)

فئة AddressValidation

google.maps.addressValidation.AddressValidation صف

فئة ثابتة للوصول إلى واجهات برمجة التطبيقات الخاصة بخدمة "التحقّق من صحة العناوين"

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressValidation} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.

fetchAddressValidation
fetchAddressValidation(request)
المَعلمات: 
قيمة العائد:  Promise<AddressValidation>
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 والمستويات الأوسع.