Address Validation

AddressValidation class

google.maps.addressValidation.AddressValidation صف
مكتبة "addressValidation"

فئة ثابتة للوصول إلى واجهات برمجة التطبيقات AddressValidation.

const {AddressValidation} = await google.maps.importLibrary("addressValidation");
fetchAddressValidation
fetchAddressValidation(request)
المَعلمات:
القيمة المعروضة: Promise<AddressValidation>
تتحقّق من صحة عنوان. يُرجى الاطّلاع على https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.
address
readonly
النوع: Address optional
معلومات عن العنوان نفسه بدلاً من الرمز الجغرافي
geocode
readonly
النوع: Geocode optional
معلومات عن الموقع الجغرافي والمكان اللذين تم ترميز العنوان جغرافيًا إليهما
metadata
readonly
النوع: AddressMetadata optional
معلومات أخرى ذات صلة بقابلية التسليم لا نضمن ملء metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.
responseId
readonly
النوع: string optional
المعرّف الفريد العالمي (UUID) الذي يحدّد هذا الردّ إذا كان يجب إعادة التحقّق من العنوان، يجب إرفاق هذا المعرّف الفريد العالمي بالطلب الجديد.
uspsData
readonly
النوع: USPSData optional
علامات إضافية لإمكانية التسليم توفّرها خدمة USPS تتوفّر هذه الميزة في المنطقة US وPR فقط.
verdict
readonly
النوع: Verdict optional
علامات البيان العام
مكتسَبة: toJSON

AddressValidationRequest interface

واجهة google.maps.addressValidation.AddressValidationRequest

واجهة الطلب لـ "AddressValidation.fetchAddressValidation"

address
العنوان الذي يتم التحقّق منه يجب إرسال العناوين غير المنسَّقة من خلال السمة PostalAddress.addressLines.
placeAutocompleteElement
اختياري
النوع: PlaceAutocompleteElement optional
في حال استخدام PlaceAutocompleteElement، يجب تضمينه هنا لربط طلبات بيانات AddressValidation API بالرمز المميّز لجلسة الإكمال التلقائي.
previousResponseId
اختياري
النوع: string optional
يجب عدم ضبط هذا الحقل لطلب التحقّق من العنوان الأول. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقّق من صحة عنوان واحد بالكامل (على سبيل المثال، إذا كانت التغييرات التي يجريها المستخدم بعد التحقّق الأولي من الصحة بحاجة إلى إعادة التحقّق من صحتها)، يجب أن يملأ كل طلب متابعة هذا الحقل باستخدام AddressValidation.responseId من الرد الأول في تسلسل التحقّق من الصحة.
sessionToken
اختياري
النوع: AutocompleteSessionToken optional
رمز مميّز يحدّد جلسة "إكمال تلقائي" لأغراض الفوترة.
uspsCASSEnabled
اختياري
النوع: boolean optional
يتم تفعيل وضع متوافق مع USPS CASS. يؤثر ذلك فقط في حقل AddressValidation.uspsData في AddressValidation. ملاحظة: بالنسبة إلى الطلبات التي تم تفعيل USPS CASS فيها للعناوين في بورتوريكو، يجب تقديم PostalAddress.regionCode من address على أنّه "PR"، أو يجب تقديم PostalAddress.administrativeArea من address على أنّه "Puerto Rico" (غير حساس لحالة الأحرف) أو "PR".

Address class

google.maps.addressValidation.Address صف
مكتبة "addressValidation"

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

const {Address} = await google.maps.importLibrary("addressValidation");
components
readonly
النوع: Array<AddressComponent>
مكوّنات العنوان الفردية للعنوان المنسَّق والمصحَّح، بالإضافة إلى معلومات التحقّق من الصحة يوفّر ذلك معلومات عن حالة التحقّق من صحة المكوّنات الفردية.
formattedAddress
readonly
النوع: string optional
العنوان الذي تمت معالجته لاحقًا، والذي تم تنسيقه كعنوان من سطر واحد باتّباع قواعد تنسيق العناوين في المنطقة التي يقع فيها العنوان
missingComponentTypes
readonly
النوع: Array<string>
أنواع المكوّنات التي كان من المتوقع أن تكون متوفّرة في عنوان بريدي منسَّق بشكل صحيح ولكن لم يتم العثور عليها في الإدخال ولم يكن من الممكن استنتاجها. لا تتوفّر مكوّنات من هذا النوع في formatted_address أو postal_address أو address_components. على سبيل المثال، قد تكون القيمة ['street_number', 'route'] لإدخال مثل "Boulder, Colorado, 80301, USA". يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا.
postalAddress
readonly
النوع: PostalAddress optional
العنوان الذي تمت معالجته لاحقًا، ويتم تمثيله كعنوان بريدي
unconfirmedComponentTypes
readonly
النوع: Array<string>
أنواع المكوّنات المتوفّرة في address_components والتي تعذّر تأكيد صحتها يتم توفير هذا الحقل لتسهيل الأمور: محتواه يعادل التكرار من خلال address_components للعثور على أنواع جميع المكوّنات التي لا تكون فيها السمة AddressComponent.confirmationLevel هي ConfirmationLevel.CONFIRMED أو لا يتم ضبط العلامة AddressComponent.inferred على true. يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا.
unresolvedTokens
readonly
النوع: Array<string>
أي رموز مميّزة في الإدخال لم يتم حلّها قد يكون هذا الإدخال غير معترف به كجزء صالح من العنوان (على سبيل المثال، في إدخال مثل "123235253253 Main St, San Francisco, CA, 94105"، قد تبدو الرموز غير المحلولة مثل ["123235253253"] لأنّها لا تبدو كرقم شارع صالح.
مكتسَبة: toJSON

فئة AddressComponent

google.maps.addressValidation.AddressComponent صف
مكتبة "addressValidation"

يمثّل مكوّنًا واحدًا من العنوان (مثل اسم الشارع والمدينة).

const {AddressComponent} = await google.maps.importLibrary("addressValidation");
componentName
readonly
النوع: string optional
نص اسم المكوّن على سبيل المثال، "شارع التحرير" لاسم الشارع أو "1253" لرقم الشارع.
componentNameLanguageCode
readonly
النوع: string optional
رمز اللغة BCP-47 لن يظهر هذا الحقل إذا لم يكن اسم المكوّن مرتبطًا بلغة، مثل رقم الشارع.
componentType
readonly
النوع: string optional
نوع مكوّن العنوان يُرجى الاطّلاع على الجدول 2: الأنواع الإضافية التي تعرضها خدمة "الأماكن" للحصول على قائمة بالأنواع المحتملة.
confirmationLevel
readonly
النوع: ConfirmationLevel optional
يشير إلى مستوى التأكّد من صحة المكوّن.
inferred
readonly
النوع: boolean
إذا كانت القيمة صحيحة (true)، هذا يعني أنّ هذا المكوّن لم يكن جزءًا من الإدخال، ولكن تم استنتاجه من الموقع الجغرافي للعنوان. يُنصح بتضمين هذا المكوّن للحصول على عنوان كامل.
replaced
readonly
النوع: boolean
يشير إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا. على سبيل المثال، استبدال رمز بريدي خاطئ بآخر صحيح للعنوان. هذا ليس تغييرًا تجميليًا؛ تم تغيير مكوّن الإدخال إلى مكوّن مختلف.
spellCorrected
readonly
النوع: boolean
يشير إلى تصحيح خطأ إملائي في اسم المكوّن. لا تضع واجهة برمجة التطبيقات دائمًا علامة على التغييرات من صيغة إملائية إلى أخرى، مثل "centre" إلى "center".
unexpected
readonly
النوع: boolean
إذا كانت القيمة صحيحة (true)، من غير المتوقّع أن يكون هذا المكوّن متوفّرًا في عنوان بريدي للمنطقة المحدّدة. وتم الاحتفاظ به فقط لأنّه كان جزءًا من الإدخال.

AddressMetadata class

google.maps.addressValidation.AddressMetadata صف
مكتبة "addressValidation"

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

const {AddressMetadata} = await google.maps.importLibrary("addressValidation");
business
readonly
النوع: boolean
poBox
readonly
النوع: boolean
residential
readonly
النوع: boolean
مكتسَبة: toJSON

ثوابت ConfirmationLevel

google.maps.addressValidation.ConfirmationLevel ثوابت
مكتبة "addressValidation"

القيم المختلفة المحتملة التي تشير إلى مستوى التأكّد من صحة المكوّن

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع ConfirmationLevelString.

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation");
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

فئة Geocode

google.maps.addressValidation.Geocode صف
مكتبة "addressValidation"

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

const {Geocode} = await google.maps.importLibrary("addressValidation");
bounds
readonly
النوع: LatLngBounds optional
حدود المكان الذي تم ترميزه جغرافيًا
featureSizeMeters
readonly
النوع: number optional
حجم المكان الذي تم ترميزه جغرافيًا، بالمتر هذا مقياس آخر لعدم دقة الموقع الجغرافي المرمّز، ولكن من حيث الحجم الفعلي وليس المعنى الدلالي.
location
readonly
النوع: LatLngAltitude optional
الموقع الجغرافي المرمّز جغرافيًا للإدخال
placeId
readonly
النوع: string optional
رقم تعريف المكان الذي تم ترميزه جغرافيًا يُفضَّل استخدام Place على استخدام العناوين أو إحداثيات خطوط العرض/الطول أو رموز Plus Codes. سيؤدي استخدام الإحداثيات لتحديد المسار أو احتساب اتجاهات القيادة دائمًا إلى تثبيت النقطة على الطريق الأقرب إلى تلك الإحداثيات. قد لا يكون هذا الطريق سريعًا أو آمنًا للوصول إلى الوجهة، وقد لا يكون قريبًا من نقطة وصول إلى الموقع الجغرافي. بالإضافة إلى ذلك، عند عكس الترميز الجغرافي لموقع جغرافي، ليس هناك ما يضمن أنّ العنوان الذي يتم عرضه سيتطابق مع العنوان الأصلي.
placeTypes
readonly
النوع: Array<string>
أنواع الأماكن التي تم ترميزها جغرافيًا في الإدخال مثلاً: ['locality', 'political'] يمكن العثور على القائمة الكاملة للأنواع في مستندات Geocoding API.
plusCode
readonly
النوع: PlusCode optional
رمز Plus Codes المقابل لـ location
fetchPlace
fetchPlace()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: لا شيء
تعرض تمثيل "مكان" لهذا الرمز الجغرافي. للحصول على تفاصيل المكان الكاملة، يجب إجراء طلب إلى place.fetchFields().
مكتسَبة: toJSON

ثوابت الدقة

google.maps.addressValidation.Granularity ثوابت
مكتبة "addressValidation"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع GranularityString.

const {Granularity} = await google.maps.importLibrary("addressValidation");
BLOCK يشير العنوان أو الرمز الجغرافي إلى مبنى. يُستخدم فقط في المناطق التي تستخدم العناوين على مستوى المبنى، مثل اليابان.
OTHER جميع مستويات التفاصيل الأخرى التي يتم تجميعها معًا لأنّها غير قابلة للتسليم
PREMISE نتيجة على مستوى المبنى
PREMISE_PROXIMITY رمز جغرافي يمثّل الموقع الجغرافي التقريبي للعنوان على مستوى المبنى
ROUTE الرمز الجغرافي أو العنوان دقيقان بما يكفي لتحديد المسار، مثل شارع أو طريق أو طريق سريع.
SUB_PREMISE نتيجة على مستوى أدنى من المبنى، مثل شقة

ثوابت PossibleNextAction

google.maps.addressValidation.PossibleNextAction ثوابت
مكتبة "addressValidation"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع PossibleNextActionString.

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation");
ACCEPT لا يتضمّن الردّ من واجهة برمجة التطبيقات إشارات تبرّر إحدى قيم PossibleNextAction الأخرى. يمكنك استخدام العنوان الذي تمت معالجته بدون طلب المزيد من المعلومات من العميل، مع العلم أنّ ذلك لا يضمن أنّ العنوان صالح، وقد يظلّ العنوان يحتوي على تصحيحات. وتقع على عاتقك مسؤولية تحديد ما إذا كان عليك طلب ذلك من العميل وكيفية إجراء ذلك، استنادًا إلى تقييمك للمخاطر.
CONFIRM يشير حقل واحد أو أكثر من ردّ من واجهة برمجة التطبيقات إلى مشاكل بسيطة محتملة في العنوان الذي تمت معالجته لاحقًا، على سبيل المثال، كان مكوّن العنوان postal_code هو replaced. قد يساعد طلب مراجعة العنوان من العميل في تحسين جودة العنوان.
CONFIRM_ADD_SUBPREMISES يشير الردّ من واجهة برمجة التطبيقات إلى أنّ العنوان الذي تمت معالجته قد لا يتضمّن مباني فرعية. قد يساعد طلب مراجعة العنوان من العميل وإضافة رقم الوحدة في تحسين جودة العنوان. قد يتضمّن العنوان الذي تمت معالجته أيضًا مشاكل بسيطة أخرى. ملاحظة: لا يمكن عرض قيمة التعداد هذه إلا للعناوين في الولايات المتحدة.
FIX يشير حقل واحد أو أكثر من حقول الردّ من واجهة برمجة التطبيقات إلى مشكلة محتملة في العنوان الذي تمت معالجته لاحقًا، على سبيل المثال، verdict.validation_granularity هو OTHER. قد يساعد طلب تعديل العنوان من العميل في تحسين جودة العنوان.

فئة USPSAddress

google.maps.addressValidation.USPSAddress صف
مكتبة "addressValidation"

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

const {USPSAddress} = await google.maps.importLibrary("addressValidation");
city
readonly
النوع: string optional
اسم المدينة
cityStateZipAddressLine
readonly
النوع: string optional
سطر العنوان الذي يحتوي على المدينة والولاية والرمز البريدي.
firm
readonly
النوع: string optional
اسم الشركة
firstAddressLine
readonly
النوع: string optional
السطر الأول من العنوان
secondAddressLine
readonly
النوع: string optional
السطر الثاني من العنوان
state
readonly
النوع: string optional
رمز الولاية المكوّن من حرفَين
urbanization
readonly
النوع: string optional
اسم المنطقة الحضرية في بورتوريكو
zipCode
readonly
النوع: string optional
الرمز البريدي، مثل "10009"
zipCodeExtension
readonly
النوع: string optional
إضافة الرمز البريدي المكوّنة من 4 أرقام، مثل "5023"
مكتسَبة: toJSON

فئة USPSData

google.maps.addressValidation.USPSData صف
مكتبة "addressValidation"

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

const {USPSData} = await google.maps.importLibrary("addressValidation");
abbreviatedCity
readonly
النوع: string optional
اسم المدينة المختصر
addressRecordType
readonly
النوع: string optional
نوع سجلّ العنوان الذي يتطابق مع العنوان الذي تم إدخاله
carrierRoute
readonly
النوع: string optional
رمز مسار شركة النقل رمز مكوّن من أربعة أحرف يتألف من بادئة من حرف واحد ومصنّف مسار من ثلاثة أرقام.
carrierRouteIndicator
readonly
النوع: string optional
مؤشر ترتيب أسعار مسارات شركات النقل
cassProcessed
readonly
النوع: boolean
مؤشر على أنّه تمت معالجة الطلب من خلال نظام CASS
county
readonly
النوع: string optional
اسم المقاطعة
deliveryPointCheckDigit
readonly
النوع: string optional
رقم الاختبار لنقطة التسليم تتم إضافة هذا الرقم إلى نهاية delivery_point_barcode للبريد الذي يتم مسحه ضوئيًا آليًا. يجب أن يؤدي جمع كل أرقام delivery_point_barcode ورقم اختبار نقطة التسليم والرمز البريدي وZIP+4 معًا إلى الحصول على رقم يقبل القسمة على 10.
deliveryPointCode
readonly
النوع: string optional
رمز نقطة التسليم المكوّن من رقمَين
dpvCMRA
readonly
النوع: string optional
يشير إلى ما إذا كان العنوان هو وكالة تجارية لاستلام البريد (CMRA)، أي نشاط تجاري خاص يتلقّى البريد للعملاء. تعرض هذه الدالة حرفًا واحدًا.
dpvConfirmation
readonly
النوع: string optional
القيم المحتملة لتأكيد DPV تعرض حرفًا واحدًا أو لا تعرض أي قيمة.
dpvDoorNotAccessible
readonly
النوع: string optional
تشير العلامة إلى العناوين التي لا يمكن لخدمة USPS طرق الباب لتسليم البريد إليها. تعرض هذه الدالة حرفًا واحدًا.
dpvDrop
readonly
النوع: string optional
تشير العلامة إلى أنّه يتم تسليم البريد إلى صندوق بريد واحد في الموقع الجغرافي. تعرض هذه الدالة حرفًا واحدًا.
dpvEnhancedDeliveryCode
readonly
النوع: string optional
يشير إلى أنّ أكثر من رمز إرجاع واحد لخدمة DPV صالح للعنوان. تعرض هذه الدالة حرفًا واحدًا.
dpvFootnote
readonly
النوع: string optional
الحواشي السفلية من عملية التحقّق من نقطة التسليم يمكن ربط حواشي سفلية متعددة معًا في السلسلة نفسها.
dpvNonDeliveryDays
readonly
النوع: string optional
تشير العلامة إلى أنّ تسليم البريد لا يتم كل يوم من أيام الأسبوع. تعرض هذه الدالة حرفًا واحدًا.
dpvNonDeliveryDaysValues
readonly
النوع: number optional
عدد صحيح يحدّد أيام عدم التسليم يمكن الاستعلام عنها باستخدام علامات البت: 0x40 – الأحد هو يوم لا يتم فيه التسليم 0x20 – الاثنين هو يوم لا يتم فيه التسليم 0x10 – الثلاثاء هو يوم لا يتم فيه التسليم 0x08 – الأربعاء هو يوم لا يتم فيه التسليم 0x04 – الخميس هو يوم لا يتم فيه التسليم 0x02 – الجمعة هو يوم لا يتم فيه التسليم 0x01 – السبت هو يوم لا يتم فيه التسليم
dpvNoSecureLocation
readonly
النوع: string optional
تشير العلامة إلى أنّه يمكن الوصول إلى الباب، ولكن لن يتم ترك الطرد بسبب مخاوف أمنية. تعرض هذه الدالة حرفًا واحدًا.
dpvNoStat
readonly
النوع: string optional
يشير إلى ما إذا كان العنوان غير نشط أو نشطًا. العناوين غير الإحصائية هي العناوين غير المشغولة بشكل مستمر أو العناوين التي لا تخدمها خدمة البريد الأمريكية (USPS). تعرض هذه الدالة حرفًا واحدًا.
dpvNoStatReasonCode
readonly
النوع: number optional
يشير إلى نوع NoStat. تعرض رمز سبب كعدد صحيح.
dpvPBSA
readonly
النوع: string optional
يشير ذلك إلى أنّه تمت مطابقة العنوان مع سجلّ PBSA. تعرض هذه الدالة حرفًا واحدًا.
dpvThrowback
readonly
النوع: string optional
يشير إلى أنّه لا يتم تسليم البريد إلى عنوان الشارع. تعرض هذه الدالة حرفًا واحدًا.
dpvVacant
readonly
النوع: string optional
تشير إلى ما إذا كان العنوان شاغرًا. تعرض هذه الدالة حرفًا واحدًا.
elotFlag
readonly
النوع: string optional
علامة eLOT التصاعدية/التنازلية (A/D).
elotNumber
readonly
النوع: string optional
رقم خط السفر المحسّن (eLOT)
errorMessage
readonly
النوع: string optional
رسالة خطأ لاسترداد بيانات USPS. يتم ملء هذا الحقل عند تعليق معالجة USPS بسبب رصد عناوين تم إنشاؤها بشكل اصطناعي.
fipsCountyCode
readonly
النوع: string optional
رمز المقاطعة وفقًا لمعيار FIPS
hasDefaultAddress
readonly
النوع: boolean
مؤشر على العثور على عنوان تلقائي، ولكن هناك عناوين أكثر تحديدًا.
hasNoEWSMatch
readonly
النوع: boolean
عنوان التسليم قابل للمطابقة، ولكن يشير ملف EWS إلى أنّ المطابقة التامة ستكون متاحة قريبًا.
lacsLinkIndicator
readonly
النوع: string optional
مؤشر LACSLink
lacsLinkReturnCode
readonly
النوع: string optional
رمز الإرجاع في LACSLink
pmbDesignator
readonly
النوع: string optional
مؤشر وحدة PMB (صندوق بريد خاص)
pmbNumber
readonly
النوع: string optional
رقم صندوق البريد الخاص (PMB)
poBoxOnlyPostalCode
readonly
النوع: boolean
الرمز البريدي لصندوق البريد فقط.
postOfficeCity
readonly
النوع: string optional
المدينة التي يقع فيها مكتب البريد الرئيسي
postOfficeState
readonly
النوع: string optional
ولاية مكتب البريد الرئيسي
standardizedAddress
readonly
النوع: USPSAddress optional
عنوان موحّد لدى خدمة USPS
suiteLinkFootnote
readonly
النوع: string optional
حواشي سفلية من مطابقة سجلّ شارع أو مبنى شاهق مع معلومات الجناح في حال العثور على تطابق لاسم المؤسسة، يتم عرض الرقم الثانوي.
مكتسَبة: toJSON

فئة البيان

google.maps.addressValidation.Verdict صف
مكتبة "addressValidation"

تمثّل هذه السمة العنوان الذي تمت معالجته بعد إرساله.

const {Verdict} = await google.maps.importLibrary("addressValidation");
addressComplete
readonly
النوع: boolean
يُعتبر العنوان مكتملاً إذا لم تكن هناك رموز مميّزة لم يتم حلّها، أو مكوّنات عنوان غير متوقّعة أو مفقودة. في حال عدم ضبطها، تشير إلى أنّ القيمة هي false. يُرجى الاطّلاع على الحقول Address.missingComponentTypes أو Address.unresolvedTokens أو AddressComponent.unexpected لمزيد من التفاصيل.
geocodeGranularity
readonly
النوع: Granularity optional
معلومات حول درجة دقة Geocode ويمكن فهم ذلك على أنّه المعنى الدلالي لمدى دقة الموقع الجغرافي الذي تم ترميزه جغرافيًا.
hasInferredComponents
readonly
النوع: boolean
تم استنتاج مكوّن واحد على الأقل من العنوان (أي تمت إضافته) لم يكن في الإدخال، راجِع AddressComponent للاطّلاع على التفاصيل.
hasReplacedComponents
readonly
النوع: boolean optional
تم استبدال مكوّن واحد على الأقل من العنوان. يُرجى الاطّلاع على AddressComponent لمزيد من التفاصيل.
hasUnconfirmedComponents
readonly
النوع: boolean
لا يمكن تصنيف أو التحقّق من صحة مكوّن واحد على الأقل من مكوّنات العنوان. يُرجى الاطّلاع على AddressComponent لمزيد من التفاصيل.
inputGranularity
readonly
النوع: Granularity optional
مستوى دقة العنوان الذي تم إدخاله هذه هي نتيجة تحليل العنوان الذي تم إدخاله ولا تقدّم أي إشارات تحقّق. للاطّلاع على إشارات التحقّق، يُرجى الرجوع إلى validationGranularity.
BetapossibleNextAction
readonly
النوع: PossibleNextAction optional
يشير هذا الحقل إلى إجراء تالٍ محتمل يمكن اتّخاذه استنادًا إلى حقول أخرى في الردّ من واجهة برمجة التطبيقات. ولمزيد من التفاصيل، يمكنك الاطّلاع على PossibleNextAction.
validationGranularity
readonly
النوع: Granularity optional
مستوى الدقة الذي يمكن لواجهة برمجة التطبيقات التحقّق من العنوان بالكامل من خلاله. على سبيل المثال، يشير validationGranularity بقيمة PREMISE إلى أنّه يمكن التحقّق من صحة جميع مكوّنات العنوان على مستوى PREMISE والمستويات الأوسع.