AddressValidation class
صف واحد (google.maps.addressValidation.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
واجهة الطلب لـ "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يتم تفعيل وضع متوافق مع USPS CASS. يؤثر ذلك فقط في حقل AddressValidation.uspsData في AddressValidation. ملاحظة: بالنسبة إلى الطلبات التي تم تفعيل USPS 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نص اسم المكوّن على سبيل المثال، "شارع التحرير" لاسم الشارع أو "1253" لرقم الشارع. |
componentNameLanguageCode |
النوع:
string optionalرمز اللغة BCP-47 لن يظهر هذا الحقل إذا لم يكن اسم المكوّن مرتبطًا بلغة، مثل رقم الشارع. |
componentType |
النوع:
string optionalنوع مكوّن العنوان يُرجى الاطّلاع على الجدول 2: الأنواع الإضافية التي تعرضها خدمة "الأماكن" للحصول على قائمة بالأنواع المحتملة. |
confirmationLevel |
النوع:
ConfirmationLevel optionalيشير إلى مستوى التأكّد من صحة المكوّن. |
inferred |
النوع:
booleanإذا كانت القيمة صحيحة (true)، هذا يعني أنّ هذا المكوّن لم يكن جزءًا من الإدخال، ولكن تم استنتاجه من الموقع الجغرافي للعنوان. يُنصح بتضمين هذا المكوّن للحصول على عنوان كامل. |
replaced |
النوع:
booleanيشير إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا. على سبيل المثال، استبدال رمز بريدي خاطئ بآخر صحيح للعنوان. هذا ليس تغييرًا تجميليًا؛ تم تغيير مكوّن الإدخال إلى مكوّن مختلف. |
spellCorrected |
النوع:
booleanيشير إلى تصحيح خطأ إملائي في اسم المكوّن. لا تضع واجهة برمجة التطبيقات دائمًا علامة على التغييرات من صيغة إملائية إلى أخرى، مثل "centre" إلى "center". |
unexpected |
النوع:
booleanإذا كانت القيمة صحيحة (true)، من غير المتوقّع أن يكون هذا المكوّن متوفّرًا في عنوان بريدي للمنطقة المحدّدة. وتم الاحتفاظ به فقط لأنّه كان جزءًا من الإدخال. |
AddressMetadata class
صف واحد (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 |
|
فئة Geocode
صف واحد (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 Street, Redwood City, CA, 94061" PREMISE، بينما يحدّد عنوان مثل "Redwood City, CA, 94061" LOCALITY. ومع ذلك، إذا لم نتمكّن من العثور على رمز جغرافي لـ "123 Main Street" في Redwood City، قد يكون الرمز الجغرافي الذي تم عرضه بمستوى دقة LOCALITY على الرغم من أنّ العنوان أكثر دقة.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {Granularity} = await google.maps.importLibrary("addressValidation").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
BLOCK |
يشير العنوان أو الرمز الجغرافي إلى مبنى. يُستخدم فقط في المناطق التي تستخدم العناوين على مستوى المبنى، مثل اليابان. |
OTHER |
جميع مستويات التفاصيل الأخرى التي يتم تجميعها معًا لأنّها غير قابلة للتسليم |
PREMISE |
نتيجة على مستوى المبنى |
PREMISE_PROXIMITY |
رمز جغرافي يمثّل الموقع الجغرافي التقريبي للعنوان على مستوى المبنى |
ROUTE |
الرمز الجغرافي أو العنوان دقيقان بما يكفي لتحديد المسار، مثل شارع أو طريق أو طريق سريع. |
SUB_PREMISE |
نتيجة على مستوى أدنى من المبنى، مثل شقة |
ثوابت PossibleNextAction
ذكرياتك الثابتة في شهر google.maps.addressValidation.PossibleNextAction
يقدّم هذا الحقل ملخّصًا تفسيريًا لردّ واجهة برمجة التطبيقات، ويهدف إلى المساعدة في تحديد الإجراء اللاحق المحتمل اتّخاذه. يتم اشتقاق هذا الحقل من حقول أخرى في الردّ من واجهة برمجة التطبيقات، ولا ينبغي اعتباره ضمانًا لدقة العنوان أو إمكانية التسليم.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم 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_barcode ورقم اختبار نقطة التسليم والرمز البريدي و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يشير إلى ما إذا كان العنوان غير نشط أو نشطًا. العناوين غير الإحصائية هي العناوين غير المشغولة بشكل مستمر أو العناوين التي لا تخدمها خدمة البريد الأمريكية (USPS). تعرض هذه الدالة حرفًا واحدًا. |
dpvNoStatReasonCode |
النوع:
number optionalيشير إلى نوع NoStat. تعرض رمز سبب كعدد صحيح. |
dpvPBSA |
النوع:
string optionalيشير ذلك إلى أنّه تمت مطابقة العنوان مع سجلّ PBSA. تعرض هذه الدالة حرفًا واحدًا. |
dpvThrowback |
النوع:
string optionalيشير إلى أنّه لا يتم تسليم البريد إلى عنوان الشارع. تعرض هذه الدالة حرفًا واحدًا. |
dpvVacant |
النوع:
string optionalتشير إلى ما إذا كان العنوان شاغرًا. تعرض هذه الدالة حرفًا واحدًا. |
elotFlag |
النوع:
string optionalعلامة eLOT التصاعدية/التنازلية (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حواشي سفلية من مطابقة سجلّ شارع أو مبنى شاهق مع معلومات الجناح في حال العثور على تطابق لاسم المؤسسة، يتم عرض الرقم الثانوي. |
فئة البيان
صف واحد (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 optionalيشير هذا الحقل إلى إجراء تالٍ محتمل يمكن اتّخاذه استنادًا إلى حقول أخرى في الردّ من واجهة برمجة التطبيقات. ولمزيد من التفاصيل، يمكنك الاطّلاع على PossibleNextAction. |
validationGranularity |
النوع:
Granularity optionalمستوى الدقة الذي يمكن لواجهة برمجة التطبيقات التحقّق من العنوان بالكامل من خلاله. على سبيل المثال، يشير validationGranularity بقيمة PREMISE إلى أنّه يمكن التحقّق من صحة جميع مكوّنات العنوان على مستوى PREMISE والمستويات الأوسع. |