Address Validation (beta)

فئة AddressValidation

google.maps.addressValidation.AddressValidation صف

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressValidation} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
BetafetchAddressValidation
fetchAddressValidation(request)
المَعلمات: 
قيمة العائد:  Promise<AddressValidation>
للتحقّق من صحة عنوان راجِع https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.
Betaaddress
النوع:  Address optional
تمثّل هذه السمة معلومات حول العنوان نفسه بدلاً من الرمز الجغرافي.
Betageocode
النوع:  Geocode optional
تمثّل هذه السمة معلومات حول الموقع الجغرافي والمكان اللذين تم ترميز العنوان جغرافيًا إليهما.
Betametadata
النوع:  AddressMetadata optional
معلومات أخرى ذات صلة بإمكانية التسليم لا نضمن أن يتم ملء الحقل metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.
BetaresponseId
النوع:  string optional
تمثّل هذه السمة المعرّف الفريد العالمي (UUID) الذي يحدّد هذه الاستجابة. إذا كان يجب إعادة التحقّق من صحة العنوان، يجب أن يكون رقم التعريف الفريد هذا مرفقًا بالطلب الجديد.
BetauspsData
النوع:  USPSData optional
علامات إضافية لتحديد إمكانية التسليم تقدّمها خدمة البريد الأمريكية (USPS) يتم توفيرها في المنطقة US وPR فقط.
Betaverdict
النوع:  Verdict optional
علامات البيان العام
BetatoJSON
toJSON()
المَعلمات:  بدون
قيمة العائد:  Object
تحويل فئة AddressValidation إلى عنصر JSON يتضمّن السمات نفسها

AddressValidationRequest interface

google.maps.addressValidation.AddressValidationRequest interface

واجهة الطلب الخاصة بـ BetaAddressValidation.fetchAddressValidation
Betaaddress
النوع:  PostalAddressLiteral
العنوان الذي يتم التحقّق منه يجب إرسال العناوين غير المنسَّقة عبر PostalAddress.addressLines.
BetapreviousResponseId optional
النوع:  string optional
يجب عدم ضبط هذا الحقل لطلب التحقّق الأول من صحة العنوان. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقّق من صحة عنوان واحد بشكل كامل (على سبيل المثال، إذا كانت التغييرات التي يجريها المستخدم بعد عملية التحقّق الأولية بحاجة إلى إعادة التحقّق)، يجب أن يملأ كل طلب متابعة هذا الحقل باستخدام BetaAddressValidation.responseId من الرد الأول في تسلسل التحقّق.
BetauspsCASSEnabled optional
النوع:  boolean optional
تفعيل وضع التوافق مع نظام CASS التابع لهيئة البريد الأمريكية يؤثّر ذلك فقط في الحقل BetaAddressValidation.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.
Betacomponents
النوع:  Array<AddressComponent>
مكوّنات العنوان الفردية للعنوان المنسَّق والمصحَّح، بالإضافة إلى معلومات التحقّق من الصحة تقدّم هذه السمة معلومات عن حالة التحقّق من صحة المكوّنات الفردية.
BetaformattedAddress
النوع:  string optional
العنوان الذي تمت معالجته بعد إدخاله، والذي تم تنسيقه كعنوان من سطر واحد باتّباع قواعد تنسيق العناوين في المنطقة التي يقع فيها العنوان
BetamissingComponentTypes
النوع:  Array<string>
أنواع المكوّنات التي كان من المتوقّع أن تكون متوفّرة في عنوان بريدي منسّق بشكلٍ صحيح ولكن لم يتم العثور عليها في الإدخال ولم يكن من الممكن استنتاجها. لا تتوفّر مكوّنات من هذا النوع في formatted_address أو postal_address أو address_components. على سبيل المثال، قد تكون القيمة ['street_number', 'route'] لمدخل مثل "Boulder, Colorado, 80301, USA". يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا.
BetapostalAddress
النوع:  PostalAddress optional
العنوان الذي تمت معالجته بعد إدخاله، ويتم تمثيله كعنوان بريدي.
BetaunconfirmedComponentTypes
النوع:  Array<string>
أنواع المكوّنات المتوفّرة في address_components ولكن تعذّر التأكّد من صحتها يتم توفير هذا الحقل لتسهيل الأمور: محتواه يعادل تكرار address_components للعثور على أنواع جميع المكوّنات التي لا تكون فيها قيمة BetaAddressComponent.confirmationLevel هي BetaConfirmationLevel.CONFIRMED أو لم يتم ضبط العلامة BetaAddressComponent.inferred على true. يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا.
BetaunresolvedTokens
النوع:  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.
BetacomponentName
النوع:  string optional
نص اسم المكوّن على سبيل المثال، "شارع 5" لاسم الشارع أو "1253" لرقم الشارع
BetacomponentNameLanguageCode
النوع:  string optional
تمثّل هذه السمة رمز اللغة المستخدَمة وفق المعيار BCP-47. لن يكون هذا الحقل متوفّرًا إذا لم يكن اسم المكوّن مرتبطًا بلغة، مثل رقم الشارع.
BetacomponentType
النوع:  string optional
تمثّل هذه السمة نوع مكوّن العنوان. راجِع الجدول 2: الأنواع الإضافية التي تعرضها خدمة "أماكن" للاطّلاع على قائمة بالأنواع المحتملة.
BetaconfirmationLevel
النوع:  ConfirmationLevel optional
تشير إلى مستوى التأكّد من صحة المكوّن.
Betainferred
النوع:  boolean
إذا كانت القيمة صحيحة، يعني ذلك أنّ هذا المكوّن لم يكن جزءًا من الإدخال، ولكن تم استنتاجه لموقع العنوان. يُنصح بتضمين هذا المكوّن للحصول على عنوان كامل.
Betareplaced
النوع:  boolean
تشير إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا. على سبيل المثال، استبدال رمز بريدي خاطئ برمز بريدي صحيح للعنوان. هذا ليس تغييرًا شكليًا، بل تم تغيير مكوّن الإدخال إلى مكوّن مختلف.
BetaspellCorrected
النوع:  boolean
تشير إلى تصحيح خطأ إملائي في اسم المكوّن. لا تضع واجهة برمجة التطبيقات علامة دائمًا على التغييرات من صيغة كتابة إلى أخرى، مثل "centre" إلى "center".
Betaunexpected
النوع:  boolean
إذا كانت القيمة صحيحة، من غير المتوقّع أن يكون هذا المكوّن متوفّرًا في عنوان بريدي للمنطقة المحدّدة. تم الاحتفاظ به فقط لأنه كان جزءًا من المدخلات.

فئة AddressMetadata

google.maps.addressValidation.AddressMetadata صف

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

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

ConfirmationLevel الثوابت

google.maps.addressValidation.ConfirmationLevel الثوابت

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

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

فئة الرمز الجغرافي

google.maps.addressValidation.Geocode صف

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Geocode} = await google.maps.importLibrary("addressValidation").
اطّلِع على المكتبات في Maps JavaScript API.
Betabounds
النوع:  LatLngBounds optional
تمثّل هذه السمة حدود المكان الذي تم ترميزه جغرافيًا.
BetafeatureSizeMeters
النوع:  number optional
حجم المكان الذي تم ترميزه جغرافيًا، بالأمتار هذا مقياس آخر لمدى دقة الموقع الجغرافي المرمّز، ولكن من حيث الحجم الفعلي وليس من حيث المعنى الدلالي.
Betalocation
النوع:  LatLngAltitude optional
الموقع الجغرافي المرمّز للإدخال
BetaplaceId
النوع:  string optional
رقم تعريف المكان الذي تم ترميزه جغرافيًا. يُفضّل استخدام Place على استخدام العناوين أو إحداثيات خطوط الطول والعرض أو رموز Plus Codes. سيؤدي استخدام الإحداثيات لتحديد المسار أو احتساب اتجاهات القيادة دائمًا إلى محاذاة النقطة مع الطريق الأقرب إلى هذه الإحداثيات. قد لا يكون هذا الطريق سريعًا أو آمنًا للوصول إلى الوجهة، وقد لا يكون بالقرب من نقطة وصول إلى المكان. بالإضافة إلى ذلك، عند تحويل الموقع الجغرافي إلى رمز جغرافي عكسي، لا يوجد ضمان بأنّ العنوان الذي تم عرضه سيتطابق مع العنوان الأصلي.
BetaplaceTypes
النوع:  Array<string>
أنواع الأماكن التي تم تحويل الإدخال إلى ترميز جغرافي لها مثلاً: ['locality', 'political'] يمكنك الاطّلاع على القائمة الكاملة للأنواع في مستندات Geocoding API.
BetaplusCode
النوع:  PlusCode optional
رمز Plus Codes المقابل لـ location
BetafetchPlace