فئة AddressValidation
google.maps.addressValidation.AddressValidation
صف
فئة ثابتة للوصول إلى واجهات برمجة التطبيقات الخاصة بخدمة "التحقّق من صحة العناوين"
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressValidation} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الطُرق الثابتة | |
---|---|
|
fetchAddressValidation(request) المَعلمات:
قيمة العائد:
Promise<AddressValidation> للتحقّق من صحة عنوان راجِع https://developers.google.com/maps/documentation/javascript/address-validation/validate-address. |
الخصائص | |
---|---|
|
النوع:
Address optional تمثّل هذه السمة معلومات حول العنوان نفسه بدلاً من الرمز الجغرافي. |
|
النوع:
Geocode optional تمثّل هذه السمة معلومات حول الموقع الجغرافي والمكان اللذين تم ترميز العنوان جغرافيًا إليهما. |
|
النوع:
AddressMetadata optional معلومات أخرى ذات صلة بإمكانية التسليم لا نضمن أن يتم ملء الحقل metadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API. |
|
النوع:
string optional تمثّل هذه السمة المعرّف الفريد العالمي (UUID) الذي يحدّد هذه الاستجابة. إذا كان يجب إعادة التحقّق من صحة العنوان، يجب أن يكون رقم التعريف الفريد هذا مرفقًا بالطلب الجديد. |
|
النوع:
USPSData optional علامات إضافية لتحديد إمكانية التسليم تقدّمها خدمة البريد الأمريكية (USPS) يتم توفيرها في المنطقة US وPR فقط. |
|
النوع:
Verdict optional علامات البيان العام |
الطُرق | |
---|---|
|
toJSON() المَعلمات: بدون
قيمة العائد:
Object تحويل فئة AddressValidation إلى عنصر JSON يتضمّن السمات نفسها |
AddressValidationRequest interface
google.maps.addressValidation.AddressValidationRequest
interface
واجهة الطلب الخاصة بـ AddressValidation.fetchAddressValidation
الخصائص | |
---|---|
|
النوع:
PostalAddressLiteral العنوان الذي يتم التحقّق منه يجب إرسال العناوين غير المنسَّقة عبر PostalAddress.addressLines . |
|
النوع:
string optional يجب عدم ضبط هذا الحقل لطلب التحقّق الأول من صحة العنوان. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقّق من صحة عنوان واحد بشكل كامل (على سبيل المثال، إذا كانت التغييرات التي يجريها المستخدم بعد عملية التحقّق الأولية بحاجة إلى إعادة التحقّق)، يجب أن يملأ كل طلب متابعة هذا الحقل باستخدام من الرد الأول في تسلسل التحقّق. |
|
النوع:
boolean optional تفعيل وضع التوافق مع نظام CASS التابع لهيئة البريد الأمريكية يؤثّر ذلك فقط في الحقل من 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.
الخصائص | |
---|---|
|
النوع:
Array<AddressComponent> مكوّنات العنوان الفردية للعنوان المنسَّق والمصحَّح، بالإضافة إلى معلومات التحقّق من الصحة تقدّم هذه السمة معلومات عن حالة التحقّق من صحة المكوّنات الفردية. |
|
النوع:
string optional العنوان الذي تمت معالجته بعد إدخاله، والذي تم تنسيقه كعنوان من سطر واحد باتّباع قواعد تنسيق العناوين في المنطقة التي يقع فيها العنوان |
|
النوع:
Array<string> أنواع المكوّنات التي كان من المتوقّع أن تكون متوفّرة في عنوان بريدي منسّق بشكلٍ صحيح ولكن لم يتم العثور عليها في الإدخال ولم يكن من الممكن استنتاجها. لا تتوفّر مكوّنات من هذا النوع في formatted_address أو postal_address أو address_components . على سبيل المثال، قد تكون القيمة ['street_number', 'route'] لمدخل مثل "Boulder, Colorado, 80301, USA". يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا. |
|
النوع:
PostalAddress optional العنوان الذي تمت معالجته بعد إدخاله، ويتم تمثيله كعنوان بريدي. |
|
النوع:
Array<string> أنواع المكوّنات المتوفّرة في address_components ولكن تعذّر التأكّد من صحتها يتم توفير هذا الحقل لتسهيل الأمور: محتواه يعادل تكرار address_components للعثور على أنواع جميع المكوّنات التي لا تكون فيها قيمة هي أو لم يتم ضبط العلامة على true . يمكنك الاطّلاع على قائمة الأنواع المحتملة هنا. |
|
النوع:
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.
الخصائص | |
---|---|
|
النوع:
string optional نص اسم المكوّن على سبيل المثال، "شارع 5" لاسم الشارع أو "1253" لرقم الشارع |
|
النوع:
string optional تمثّل هذه السمة رمز اللغة المستخدَمة وفق المعيار BCP-47. لن يكون هذا الحقل متوفّرًا إذا لم يكن اسم المكوّن مرتبطًا بلغة، مثل رقم الشارع. |
|
النوع:
string optional تمثّل هذه السمة نوع مكوّن العنوان. راجِع الجدول 2: الأنواع الإضافية التي تعرضها خدمة "أماكن" للاطّلاع على قائمة بالأنواع المحتملة. |
|
النوع:
ConfirmationLevel optional تشير إلى مستوى التأكّد من صحة المكوّن. |
|
النوع:
boolean إذا كانت القيمة صحيحة، يعني ذلك أنّ هذا المكوّن لم يكن جزءًا من الإدخال، ولكن تم استنتاجه لموقع العنوان. يُنصح بتضمين هذا المكوّن للحصول على عنوان كامل. |
|
النوع:
boolean تشير إلى أنّه تم استبدال اسم المكوّن باسم مختلف تمامًا. على سبيل المثال، استبدال رمز بريدي خاطئ برمز بريدي صحيح للعنوان. هذا ليس تغييرًا شكليًا، بل تم تغيير مكوّن الإدخال إلى مكوّن مختلف. |
|
النوع:
boolean تشير إلى تصحيح خطأ إملائي في اسم المكوّن. لا تضع واجهة برمجة التطبيقات علامة دائمًا على التغييرات من صيغة كتابة إلى أخرى، مثل "centre" إلى "center". |
|
النوع:
boolean إذا كانت القيمة صحيحة، من غير المتوقّع أن يكون هذا المكوّن متوفّرًا في عنوان بريدي للمنطقة المحدّدة. تم الاحتفاظ به فقط لأنه كان جزءًا من المدخلات. |
فئة AddressMetadata
google.maps.addressValidation.AddressMetadata
صف
البيانات الوصفية الخاصة بالعنوان لا يمكن ضمان تعبئة AddressMetadata بالكامل لكل عنوان يتم إرساله إلى Address Validation API.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AddressMetadata} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
---|---|
|
النوع:
boolean |
|
النوع:
boolean |
|
النوع:
boolean |
ConfirmationLevel الثوابت
google.maps.addressValidation.ConfirmationLevel
الثوابت
القيم المختلفة المحتملة التي تشير إلى مستوى اليقين بأنّ المكوّن صحيح.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الثوابت | |
---|---|
|
|
|
|
|
فئة الرمز الجغرافي
google.maps.addressValidation.Geocode
صف
يحتوي على معلومات حول المكان الذي تم ترميز الإدخال جغرافيًا إليه.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Geocode} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
---|---|
|
النوع:
LatLngBounds optional تمثّل هذه السمة حدود المكان الذي تم ترميزه جغرافيًا. |
|
النوع:
number optional حجم المكان الذي تم ترميزه جغرافيًا، بالأمتار هذا مقياس آخر لمدى دقة الموقع الجغرافي المرمّز، ولكن من حيث الحجم الفعلي وليس من حيث المعنى الدلالي. |
|
النوع:
LatLngAltitude optional الموقع الجغرافي المرمّز للإدخال |
|
النوع:
string optional رقم تعريف المكان الذي تم ترميزه جغرافيًا. يُفضّل استخدام Place على استخدام العناوين أو إحداثيات خطوط الطول والعرض أو رموز Plus Codes. سيؤدي استخدام الإحداثيات لتحديد المسار أو احتساب اتجاهات القيادة دائمًا إلى محاذاة النقطة مع الطريق الأقرب إلى هذه الإحداثيات. قد لا يكون هذا الطريق سريعًا أو آمنًا للوصول إلى الوجهة، وقد لا يكون بالقرب من نقطة وصول إلى المكان. بالإضافة إلى ذلك، عند تحويل الموقع الجغرافي إلى رمز جغرافي عكسي، لا يوجد ضمان بأنّ العنوان الذي تم عرضه سيتطابق مع العنوان الأصلي. |
|
النوع:
Array<string> أنواع الأماكن التي تم تحويل الإدخال إلى ترميز جغرافي لها مثلاً: ['locality', 'political'] يمكنك الاطّلاع على القائمة الكاملة للأنواع في مستندات Geocoding API. |
|
النوع:
PlusCode optional رمز Plus Codes المقابل لـ location |
الطُرق | |
---|---|
|
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.
الثوابت | |
---|---|
|
يشير العنوان أو الرمز الجغرافي إلى مبنى سكني. تُستخدم فقط في المناطق التي تتضمّن عناوين على مستوى المبنى، مثل اليابان. |
|
جميع مستويات التفاصيل الأخرى، والتي يتم تجميعها معًا لأنّها غير قابلة للتسليم |
|
نتيجة على مستوى المبنى: |
|
رمز جغرافي يقدّم تقريبًا الموقع الجغرافي للعنوان على مستوى المبنى. |
|
تكون الرموز الجغرافية أو العناوين دقيقة بما يكفي لتحديد المسار، مثل شارع أو طريق أو طريق سريع. |
|
نتيجة على مستوى أقل من المبنى، مثل شقة |
فئة USPSAddress
google.maps.addressValidation.USPSAddress
صف
تمثيل USPS لعنوان في الولايات المتحدة
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {USPSAddress} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
---|---|
|
النوع:
string optional اسم المدينة |
|
النوع:
string optional سطر العنوان الذي يتضمّن المدينة والولاية والرمز البريدي |
|
النوع:
string optional اسم الشركة |
|
النوع:
string optional السطر الأول من العنوان |
|
النوع:
string optional تمثّل هذه السمة السطر الثاني من العنوان. |
|
النوع:
string optional تمثّل هذه السمة رمز الولاية المكوَّن من حرفين. |
|
النوع:
string optional تمثّل هذه السمة اسم المنطقة الحضرية في بورتوريكو. |
|
النوع:
string optional الرمز البريدي، مثل "10009" |
|
النوع:
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.
الخصائص | |
---|---|
|
النوع:
string optional المدينة المختصَرة |
|
النوع:
string optional نوع سجلّ العنوان الذي يتطابق مع العنوان المُدخَل. |
|
النوع:
string optional تمثّل هذه السمة رمز مسار مشغّل شبكة الجوّال. رمز مكوّن من أربعة أحرف ويتألف من بادئة من حرف واحد ومحدّد مسار مكوّن من ثلاثة أرقام. |
|
النوع:
string optional مؤشر ترتيب أسعار مسارات شركات النقل |
|
النوع:
boolean مؤشر على أنّه تمت معالجة الطلب باستخدام نظام CASS. |
|
النوع:
string optional اسم المقاطعة |
|
النوع:
string optional رقم التحقّق الخاص بنقطة التسليم يُضاف هذا الرقم إلى نهاية الرمز الشريطي لنقطة التسليم الخاص بالبريد الذي يتم مسحه ضوئيًا آليًا. يجب أن يؤدي جمع كل أرقام delivery_point_barcode وdelivery_point_check_digit والرمز البريدي وZIP+4 إلى الحصول على رقم قابل للقسمة على 10. |
|
النوع:
string optional تمثّل هذه السمة رمز نقطة التسليم المكوّن من رقمَين. |
|
النوع:
string optional تشير إلى ما إذا كان العنوان هو وكالة استلام البريد التجاري (CMRA)، وهي مؤسسة خاصة تستلم البريد نيابةً عن العملاء. لعرض حرف واحد. |
|
النوع:
string optional القيم المحتملة لتأكيد DPV تعرض هذه الدالة حرفًا واحدًا أو لا تعرض أي قيمة. |
|
النوع:
string optional تشير العلامة إلى العناوين التي لا يمكن فيها لمصلحة البريد الأمريكية (USPS) طرق الباب لتسليم البريد. لعرض حرف واحد. |
|
النوع:
string optional يشير العلم إلى أنّه يتم تسليم البريد إلى صندوق واحد في الموقع. لعرض حرف واحد. |
|
النوع:
string optional تشير إلى أنّ هناك أكثر من رمز إرجاع DPV صالح للعنوان. لعرض حرف واحد. |
|
النوع:
string optional الحواشي السفلية من عملية التحقّق من نقطة التسليم يمكن ربط حواشٍ سفلية متعددة في السلسلة نفسها. |
|
النوع:
string optional تشير العلامة إلى أنّه لا يتم تسليم البريد كل يوم من أيام الأسبوع. لعرض حرف واحد. |
|
النوع:
number optional عدد صحيح يحدّد أيام عدم التسليم. يمكن الاستعلام عنه باستخدام علامات البت: 0x40 – الأحد هو يوم لا يتم فيه التسليم 0x20 – الاثنين هو يوم لا يتم فيه التسليم 0x10 – الثلاثاء هو يوم لا يتم فيه التسليم 0x08 – الأربعاء هو يوم لا يتم فيه التسليم 0x04 – الخميس هو يوم لا يتم فيه التسليم 0x02 – الجمعة هو يوم لا يتم فيه التسليم 0x01 – السبت هو يوم لا يتم فيه التسليم |
|
النوع:
string optional تشير العلامة إلى أنّه يمكن الوصول إلى الباب، ولكن لن يتم ترك الحزمة بسبب مخاوف أمنية. لعرض حرف واحد. |
|
النوع:
string optional تشير إلى ما إذا كان العنوان لا يتضمّن إحصاءات أو كان عنوانًا نشطًا. لا يمكن استخدام عناوين إحصائية غير مشغولة باستمرار أو عناوين لا تقدّم هيئة البريد الأمريكية خدماتها إليها. لعرض حرف واحد. |
|
النوع:
number optional يشير إلى نوع NoStat. تعرض هذه السمة رمز السبب كعدد صحيح. |
|
النوع:
string optional يشير إلى أنّه تمّت مطابقة العنوان مع سجلّ PBSA. لعرض حرف واحد. |
|
النوع:
string optional تشير إلى أنّه لا يتم تسليم البريد إلى عنوان الشارع. لعرض حرف واحد. |
|
النوع:
string optional تشير إلى ما إذا كان العنوان شاغرًا. لعرض حرف واحد. |
|
النوع:
string optional علامة ترتيب الأولوية الإلكترونية تصاعديًا/تنازليًا (A/D) |
|
النوع:
string optional رقم "خط السير المحسّن" (eLOT) |
|
النوع:
string optional رسالة خطأ بشأن استرداد بيانات USPS يتم ملء هذا الحقل عند تعليق معالجة USPS بسبب رصد عناوين تم إنشاؤها بشكل مصطنع. |
|
النوع:
string optional رمز FIPS للمقاطعة |
|
النوع:
boolean مؤشر على أنّه تم العثور على عنوان تلقائي، ولكن توجد عناوين أكثر تحديدًا. |
|
النوع:
boolean يمكن مطابقة عنوان التسليم، ولكن يشير ملف EWS إلى أنّ المطابقة التامة ستتوفّر قريبًا. |
|
النوع:
string optional مؤشر LACSLink |
|
النوع:
string optional رمز الإرجاع LACSLink |
|
النوع:
string optional معرّف وحدة صندوق البريد الخاص (PMB) |
|
النوع:
string optional رقم صندوق البريد الخاص (PMB) |
|
النوع:
boolean الرمز البريدي الخاص بصندوق البريد فقط |
|
النوع:
string optional تمثّل هذه السمة المدينة التي يقع فيها مكتب البريد الرئيسي. |
|
النوع:
string optional تمثّل هذه السمة الولاية التي يقع فيها مكتب البريد الرئيسي. |
|
النوع:
USPSAddress optional عنوان موحّد لدى USPS |
|
النوع:
string optional حواشٍ سفلية من مطابقة سجلّ شارع أو مبنى مرتفع مع معلومات الجناح في حال العثور على تطابق في اسم المؤسسة، يتم عرض الرقم الثانوي. |
Verdict class
google.maps.addressValidation.Verdict
صف
تمثّل هذه السمة العنوان الذي تمت معالجته بعد إدخاله.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Verdict} = await google.maps.importLibrary("addressValidation")
.
اطّلِع على المكتبات في Maps JavaScript API.
الخصائص | |
---|---|
|
النوع:
boolean يُعدّ العنوان مكتملاً إذا لم تكن هناك رموز غير محلولة، ولم تكن هناك مكوّنات عنوان غير متوقّعة أو مفقودة. إذا لم يتم ضبطها، يشير ذلك إلى أنّ القيمة هي false . يُرجى الاطّلاع على الحقول أو أو لمزيد من التفاصيل. |
|
النوع:
Granularity optional معلومات حول درجة دقة Geocode يمكن فهم ذلك على أنّه المعنى الدلالي لمدى دقة الموقع الجغرافي المرمّز جغرافيًا. |
|
النوع:
boolean تم استنتاج (أي إضافة) مكوّن عنوان واحد على الأقل لم يكن في الإدخال، راجِع AddressComponent للاطّلاع على التفاصيل. |
|
النوع:
boolean optional تم استبدال مكوّن عنوان واحد على الأقل، راجِع AddressComponent للحصول على التفاصيل. |
|
النوع:
boolean لا يمكن تصنيف مكوّن عنوان واحد على الأقل أو التحقّق من صحته، راجِع AddressComponent للحصول على التفاصيل. |
|
النوع:
Granularity optional مستوى تفصيل عنوان الإدخال هذه هي نتيجة تحليل العنوان المُدخَل ولا تقدّم أي إشارات للتحقّق من صحته. للحصول على إشارات التحقّق، يُرجى الرجوع إلى validationGranularity . |
|
النوع:
Granularity optional مستوى التفاصيل الذي يمكن لواجهة برمجة التطبيقات التحقّق من صحة العنوان بالكامل. على سبيل المثال، يشير validationGranularity بقيمة PREMISE إلى أنّه يمكن التحقّق من صحة جميع مكوّنات العنوان على مستوى PREMISE والمستويات الأوسع. |