Package google.maps.addressvalidation.v1

الفهرس

AddressValidation

خدمة التحقّق من صحة العناوين

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

للتحقق من صحة أحد العناوين

العنوان

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

الحقول
formatted_address

string

هو العنوان الذي تمّت معالجته بعد ذلك، والذي يتم تنسيقه كعنوان مكوَّن من سطر واحد ويتبع قواعد تنسيق العناوين للمنطقة التي يقع فيها العنوان.
postal_address

PostalAddress

تمثّل هذه السمة العنوان الذي تمّت معالجته بعد اكتماله كعنوان بريدي.
address_components[]

AddressComponent

قائمة بدون ترتيب. مكوّنات العنوان الفردي للعنوان الذي تم تنسيقه وتصحيحه، بالإضافة إلى معلومات التحقّق من الصحة يوفر هذا معلومات عن حالة التحقق من المكونات الفردية.

لا يتم ترتيب مكونات العنوان بطريقة معينة. لا تضع أي افتراضات بشأن ترتيب مكوّنات العنوان في القائمة.
missing_component_types[]

string

تعذّر استنتاج أنواع المكوّنات التي كان من المتوقّع وجودها في عنوان بريدي بتنسيق صحيح ولكن لم يتم العثور عليها في الإدخال، وتعذّر استنتاجها. مكوّنات هذا النوع غير متوفّرة في formatted_address أو postal_address أو address_components. من الأمثلة على ذلك ['street_number', 'route'] لإدخال، مثل "بولدر، كولورادو، 80301، الولايات المتحدة". يمكن الاطّلاع على قائمة الأنواع المحتمَلة هنا.
unconfirmed_component_types[]

string

تمثّل هذه السمة أنواع المكوّنات المتوفّرة في address_components ولكن تعذّر التأكّد من صحتها. تم توفير هذا الحقل لتيسير الأمر: فمحتوياته مكافئة للتكرار من خلال address_components للعثور على أنواع جميع المكوّنات حيث لا تكون السمة confirmation_level هي CONFIRMED أو لم يتم ضبط علامة inferred على true. يمكن الاطّلاع على قائمة الأنواع المحتمَلة هنا.
unresolved_tokens[]

string

يشير هذا المصطلح إلى أي رموز مميّزة في الإدخال لم نتمكّن من حلّها. قد يكون ذلك إدخالاً لم يتم التعرّف عليه كجزء من عنوان صالح (على سبيل المثال، في إدخال مثل "123235253253 Main St, San Francisco, CA, 94105"، قد تبدو الرموز المميزة التي لم يتم حلها بالتنسيق ["123235253253"] لأنّ ذلك لا يبدو رقم شارع صالحًا.

AddressComponent

يمثل مكون عنوان، مثل شارع أو مدينة أو ولاية.

الحقول
component_name

ComponentName

اسم هذا المكون.
component_type

string

نوع مكوِّن العنوان. راجع الجدول 2: الأنواع الإضافية التي تعرضها خدمة الأماكن للحصول على قائمة بالأنواع المحتملة.
confirmation_level

ConfirmationLevel

يشير إلى مستوى اليقين الذي لدينا من صحة المكون.
inferred

bool

يشير إلى أن المكوِّن لم يكن جزءًا من الإدخال، ولكننا استنتجنا ذلك لموقع العنوان ونعتقد أنه يجب تقديمه لعنوان كامل.
spell_corrected

bool

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

bool

تشير إلى استبدال اسم المكوِّن برمز مختلف تمامًا، على سبيل المثال، يتم استبدال رمز بريدي غير صحيح برمز صحيح للعنوان. وهذا ليس تغييرًا تجميليًا، فقد تم تغيير مكوِّن الإدخال إلى مكوِّن آخر.
unexpected

bool

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

ConfirmationLevel

القيم المختلفة المحتملة لمستويات التأكيد.

عمليات التعداد
CONFIRMATION_LEVEL_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
CONFIRMED تمكنا من التحقق من وجود هذا المكون ووجوده منطقي في سياق باقي العنوان.
UNCONFIRMED_BUT_PLAUSIBLE تعذّر تأكيد هذا العنصر، ولكن من المحتمل وجوده. على سبيل المثال، رقم شارع ضمن نطاق صالح معروف من الأرقام في شارع لا تُعرَف فيه أرقام منازل معيّنة.
UNCONFIRMED_AND_SUSPICIOUS لم يتم تأكيد هذا المكوِّن ومن المحتمل أن يكون غير صحيح. على سبيل المثال، حي لا يناسب بقية العنوان.

AddressMetadata

البيانات الوصفية للعنوان. ليس من المضمون تعبئة metadata بالكامل لكل عنوان يتم إرساله إلى واجهة برمجة تطبيقات التحقُّق من صحة العناوين.

الحقول
business

bool

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

bool

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

bool

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

ComponentName

برنامج تضمين لاسم المكوِّن.

الحقول
text

string

نص الاسم. على سبيل المثال، يمكنك استخدام "الجادة الخامسة" لاسم الشارع أو "1253" لرقم الشارع.
language_code

string

تمثّل هذه السمة رمز اللغة BCP-47. لن يكون ذلك موجودًا إذا لم يكن اسم المكوِّن مقترنًا بلغة، مثل رقم شارع.

الترميز الجغرافي

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

الحقول
location

LatLng

الموقع المرمَّز جغرافيًا للإدخال.

يُفضَّل استخدام أرقام تعريف الأماكن بدلاً من استخدام العناوين أو إحداثيات خطوط الطول/العرض أو رموز الموقع المفتوح. سيؤدي استخدام الإحداثيات عند التوجيه أو حساب اتجاهات القيادة دائمًا إلى محاذاة النقطة إلى الطريق الأقرب إلى تلك الإحداثيات. وقد لا تكون هذه الطريق طريقًا تؤدّي إلى الوجهة بسرعة أو بأمان وقد لا تكون قريبة من نقطة وصول إلى الموقع. بالإضافة إلى ذلك، عندما يتم ترميز موقع جغرافي عكسيًا، ليس هناك ما يضمن تطابُق العنوان المعروض مع العنوان الأصلي.
plus_code

PlusCode

تمثّل هذه السمة رمز الموقع المفتوح المقابل لـ location.
bounds

Viewport

حدود المكان الذي تم ترميزه جغرافيًا.
feature_size_meters

float

حجم المكان المشفر جغرافيًا، بالأمتار. وهذا مقياس آخر لشحونة الموقع الجغرافي المُرمَّز جغرافيًا، ولكن من حيث الحجم الفعلي بدلاً من المعنى الدلالي.
place_id

string

رقم تعريف المكان للمكان الذي يتم فيه ترميز هذا الإدخال الجغرافي.

لمزيد من المعلومات عن أرقام تعريف الأماكن، اطّلِع هنا.
place_types[]

string

تمثّل هذه السمة أنواع المكان الذي تم ترميز الإدخال فيه جغرافيًا. مثلاً: ['locality', 'political'] يمكن العثور على القائمة الكاملة للأنواع هنا.

LanguageOptions

المعاينة: تتوفّر هذه الميزة في مرحلة المعاينة (ما قبل التوفّر للجمهور العام). قد يتوفّر دعم محدود للمنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام، وقد لا تتوافق التغييرات في المنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة في مرحلة ما قبل التوفّر للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مرحلة الإطلاق.

لتفعيل واجهة برمجة تطبيقات التحقق من صحة العنوان الجغرافي لتضمين معلومات إضافية في الرد.

الحقول
return_english_latin_address

bool

معاينة: عرض google.maps.addressvalidation.v1.Address باللغة الإنجليزية لمزيد من التفاصيل، انتقِل إلى google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

PlusCode

رمز Plus Codes (http://plus.codes) هو مرجع موقع جغرافي بتنسيقَين: رمز عام يحدّد 14 م في 14 م (1/8000 من الدرجة) أو مستطيل أصغر، ورمز مركّب، مع استبدال البادئة بموقع مرجعي.

الحقول
global_code

string

الرمز العالمي (الكامل) للمكان، مثل "9FWM33GV+HQ"، الذي يمثل مساحة 1/8000 في 1/8000 درجة (14 × 14 متر تقريبًا).
compound_code

string

الرمز المركّب للمكان، مثل "33GV+HQ, Ramberg, Norway"، الذي يحتوي على لاحقة الرمز العام ويستبدل البادئة باسم منسق للكيان المرجعي.

ProvideValidationFeedbackRequest

تمثّل هذه السمة طلب إرسال ملاحظات بشأن التحقّق من الصحة.

الحقول
conclusion

ValidationConclusion

مطلوبة. هي نتيجة سلسلة محاولات التحقق.

في حال ضبط هذا الحقل على VALIDATION_CONCLUSION_UNSPECIFIED، سيظهر خطأ INVALID_ARGUMENT.
response_id

string

مطلوبة. تمثّل هذه السمة رقم تعريف الردّ المخصّص لهذه الملاحظات. يجب أن تكون هذه القيمة [response_id][google.maps.addressصالation.v1.VerifyAddressRequest.response_id] من الاستجابة الأولى في سلسلة من محاولات التحقق من العنوان.

ValidationConclusion

يشير ذلك المصطلح إلى النتائج النهائية المحتمَلة لتسلسل طلبات التحقّق من العنوان اللازمة للتحقّق من صحة العنوان.

عمليات التعداد
VALIDATION_CONCLUSION_UNSPECIFIED هذه القيمة غير مستخدمة. وفي حال ضبط الحقل ProvideValidationFeedbackRequest.conclusion على VALIDATION_CONCLUSION_UNSPECIFIED، سيظهر خطأ INVALID_ARGUMENT.
VALIDATED_VERSION_USED تم استخدام نسخة العنوان التي تعرضها واجهة برمجة تطبيقات التحقق من صحة العنوان في المعاملة.
USER_VERSION_USED إنّ نسخة العنوان التي قدّمها المستخدم استُخدمت لإجراء المعاملة.
UNVALIDATED_VERSION_USED تم استخدام نسخة من العنوان في المعاملة تم إدخالها بعد آخر محاولة تحقّق ولكن لم تتم إعادة التحقّق من صحتها.
UNUSED تم إلغاء المعاملة ولم يتم استخدام العنوان.

ProvideValidationFeedbackResponse

لا يحتوي هذا النوع على أي حقول.

تمثّل هذه السمة الرد على الملاحظات والآراء المتعلقة بالتحقّق من الصحة.

إذا تم إرسال الملاحظات بنجاح، يكون الردّ فارغًا.

UspsAddress

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

الحقول
first_address_line

string

سطر العنوان الأول.
firm

string

اسم الشركة.
second_address_line

string

سطر العنوان الثاني.
urbanization

string

اسم التحضر في بورتوريكو.
city_state_zip_address_line

string

المدينة + الولاية + الرمز البريدي.
city

string

اسم المدينة.
state

string

رمز حالة مكوّن من حرفَين.
zip_code

string

الرمز البريدي مثل 10009.
zip_code_extension

string

إضافة الرمز البريدي المكونة من 4 أرقام مثل 5023.

UspsData

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

الحقول
standardized_address

UspsAddress

عنوان USPS الموحّد.
delivery_point_code

string

رمز نقطة تسليم من رقمَين
delivery_point_check_digit

string

رقم فحص نقطة التسليم تتم إضافة هذا الرقم إلى نهاية delivery_point_barcode للبريد الذي يتم مسحه ضوئيًا آليًا. عند جمع جميع أرقام delivery_point_barcode وdelivery_point_check_Number والرمز البريدي وZIP+4 معًا يجب أن يكون الناتج عددًا قابلاً للقسمة على 10.
dpv_confirmation

string

القيم المحتملة لتأكيد DPV. لعرض حرف واحد أو عدم عرض أي قيمة.

  • N: تعذَّر تأكيد DPV لمعلومات الرقم الأساسي وأي رقم ثانوي.
  • D: تم تأكيد DPV للرقم الأساسي فقط، ولم تتوفّر معلومات الرقم الثانوي.
  • S: تم تأكيد عنوان DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي متوفّرة ولكن لم يتم تأكيدها.
  • Y: تم تأكيد العنوان DPV للأرقام الأساسية وأي أرقام ثانوية.
  • فارغ: إذا لم يتضمّن الردّ قيمة dpv_confirmation، هذا يعني أنّه لم يتم إرسال العنوان لتأكيد DPV.
dpv_footnote

string

الحواشي السفلية من عملية التحقّق من نقطة التسليم. يمكن ربط عدة حواشٍ سفلية معًا في نفس السلسلة.

  • AA: عنوان الإدخال مطابق لملف ZIP+4
  • A1: لم تتم مطابقة عنوان الإدخال مع ملف ZIP+4
  • BB: مطابقة مع DPV (جميع المكوّنات)
  • CC: الرقم الثانوي غير مطابق وغير مطلوب
  • C1: الرقم الثانوي غير مطابق ولكنه مطلوب
  • N1: عنوان شاهق لا يفتقر إلى رقم ثانوي
  • M1: الرقم الأساسي غير متوفّر
  • M3: الرقم الأساسي غير صالح
  • P1: إدخال عنوان البريد الإلكتروني أو رقم RR أو رقم صندوق "مركز المساعدة" غير متوفّر
  • P3: عنوان إدخال رقم طلب الشراء أو رقم RR أو رقم صندوق مركز المساعدة غير صالح
  • F1: عنوان إدخال مطابق لعنوان عسكري
  • G1: عنوان الإدخال مطابق لعنوان تسليم عام
  • U1: عنوان إدخال مطابق لرمز بريدي فريد
  • PB: عنوان إدخال مطابق لسجلّ PBSA
  • RR: عنوان تم تأكيد DPV فيه مع معلومات PMB
  • R1: عنوان تم تأكيد DPV بدون معلومات PMB
  • R7: مسار شركة النقل R777 أو R779
  • IA: تم تحديد العنوان المطّلع
  • TA: رقم أساسي مطابق لإسقاط ألفا لاحقة
dpv_cmra

string

يشير إلى ما إذا كان العنوان تابعًا لوكالة تلقّي البريد التجارية (CMRA)--مؤسسة تجارية خاصة تتلقى البريد للعملاء. تعرض حرفًا واحدًا.

  • Y: العنوان هو قانون CMRA
  • N: العنوان ليس حساب CMRA
dpv_vacant

string

هل هذا المكان خالٍ؟ تعرض حرفًا واحدًا.

  • Y: العنوان شاغر
  • N: العنوان غير شاغر
dpv_no_stat

string

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

  • Y: العنوان غير نشط
  • N: العنوان نشط
dpv_no_stat_reason_code

int32

يشير إلى نوع NoStat. تعرض رمز السبب على هيئة int.

  • 1: العناوين التي لا تتلقّى رسائل إلكترونية من خدمة USPS مباشرةً، ولكن يتم توصيلها إلى عنوان تسليم يوفّرها الخدمة.
  • 2: CDS: العناوين التي لم يتم تسليمها بعد. على سبيل المثال، تقسيم فرعي جديد تم فيه تحديد الكثير والأرقام الأساسية، ولكن لا يوجد هيكل للإشغال بعد.
  • 3: الاصطدام - العناوين التي لا يتم تأكيد DPV فيها فعليًا.
  • 4: CMZ (الكليات والعسكرية والأنواع الأخرى) - تم دمج ZIP + 4 سجلات USPS في البيانات.
  • 5: عادي - يشير إلى العناوين التي لا يتم تسليمها ولا يتم احتساب العناوين ضمن عمليات التسليم الممكنة.
  • 6: عنوان ثانوي مطلوب - يتطلب العنوان معلومات ثانوية.
dpv_drop

string

تشير العلامة إلى أن البريد تم تسليمه إلى مستخدم واحد مستقبِل في الموقع. تعرض حرفًا واحدًا.

  • Y: يتم تسليم البريد إلى مُستلم واحد في موقع إلكتروني.
  • N: لا يتم تسليم البريد إلى جهاز مُستلم واحد في أحد المواقع الإلكترونية.
dpv_throwback

string

يشير إلى عدم تسليم البريد إلى عنوان الشارع. تعرض حرفًا واحدًا.

  • Y: لم يتم تسليم البريد إلى عنوان الشارع.
  • N: يتم تسليم البريد إلى عنوان الشارع.
dpv_non_delivery_days

string

تشير هذه العلامة إلى عدم تسليم البريد في كل يوم من أيام الأسبوع. تعرض حرفًا واحدًا.

  • Y: لا يتم تسليم البريد كل يوم من أيام الأسبوع.
  • N: ما مِن إشارة إلى أنّه لا يتم تسليم البريد كل يوم من أيام الأسبوع.
dpv_non_delivery_days_values

int32

عدد صحيح يحدد أيام عدم التسليم. ويمكن الاستفسار عنه باستخدام علامات بت: 0x40 - يوم الأحد 0x40 - يوم الأحد 0x20 - الاثنين هو يوم عدم تسليم 0x10 - يوم الثلاثاء 0x08 - يوم عدم التسليم 0x08 - يوم الأربعاء 0x04 - يوم الخميس 0x04 - يوم الخميس 0x02 - يوم الجمعة هو يوم عدم التسليم 0x02 - يوم الجمعة هو يوم عدم التسليم 0x
dpv_no_secure_location

string

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

  • Y: لن يتم ترك الطرد بسبب مخاوف تتعلق بالأمان.
  • N: ما مِن إشارة إلى أنّه لن يتم ترك الطرد بسبب مخاوف أمنية.
dpv_pbsa

string

يشير إلى مطابقة العنوان مع سجلّ PBSA. تعرض حرفًا واحدًا.

  • Y: تمت مطابقة العنوان مع سجلّ PBSA.
  • N: لم تتم مطابقة العنوان مع سجلّ PBSA.
dpv_door_not_accessible

string

تشير العلامة إلى العناوين التي لا يمكن لـ USPS النقر على باب لتسليم البريد. تعرض حرفًا واحدًا.

  • Y: يتعذّر الوصول إلى الباب.
  • N: ما مِن إشارة إلى أنّه يتعذّر الوصول إلى الباب.
dpv_enhanced_delivery_code

string

يشير هذا الرمز إلى أنّ هناك أكثر من رمز DPV واحد صالح للعنوان. تعرض حرفًا واحدًا.

  • Y: تم تأكيد العنوان DPV للأرقام الأساسية وأي أرقام ثانوية.
  • N: تعذَّر تأكيد DPV لمعلومات الرقم الأساسي وأي رقم ثانوي.
  • S: تم تأكيد DPV للرقم الأساسي فقط، وكانت معلومات الرقم الثانوي متوفّرة ولكن لم يتم تأكيدها، أو تم إسقاط ألفا لاحقة واحدة على رقم أساسي لإجراء مطابقة DPV مع توفير معلومات ثانوية.
  • D: تم تأكيد DPV للرقم الأساسي فقط، ولم تتوفّر معلومات الرقم الثانوي.
  • R: تم تأكيد العنوان ولكن تم تعيينه للمسار الوهمي R777 وR779 ولا يتم تقديم خدمة التسليم من خلال USPS.
carrier_route

string

رمز مسار شركة النقل. رمز مكوّن من أربعة أحرف ويتكوّن من بادئة من حرف واحد ورمز مسار مكوّن من ثلاثة أرقام.

البادئات:

  • C: مسار شركة النقل (أو مسار المدينة)
  • R: طريق ريفي
  • H: مسار عقد الطريق السريع
  • B: قسم صندوق البريد
  • G: وحدة تسليم عامة
carrier_route_indicator

string

مؤشر ترتيب معدل مسارات شركات النقل.
ews_no_match

bool

عنوان التسليم مطابق، إلا أن ملف خدمات Exchange عبر الويب (EWS) يشير إلى أن هناك تطابقًا تامًا ستتوفّر قريبًا.
post_office_city

string

مدينة مكتب البريد الرئيسية.
post_office_state

string

ولاية مكتب البريد الرئيسية.
abbreviated_city

string

اسم المدينة المختصر.
fips_county_code

string

رمز المقاطعة FIPS.
county

string

اسم المقاطعة.
elot_number

string

رقم خط السفر المحسّن (eLOT).
elot_flag

string

علامة eLOT تصاعدية/تنازلية (A/D)
po_box_only_postal_code

bool

الرمز البريدي لصندوق البريد فقط
pmb_designator

string

محدِّد وحدة PMB (صندوق البريد الخاص).
pmb_number

string

رقم PMB (صندوق البريد الخاص)
address_record_type

string

نوع سجلّ العناوين الذي يتطابق مع العنوان الذي تم إدخاله

  • F: ثابت. ويتطابق هذا مع سجلّ الشركة، وهو أفضل مستوى من المطابقة متاح للعنوان.
  • G: العرض العام هذه مطابقة لسجلّ التسليم العام.
  • H: البناء / الشقة هذا الحقل مطابق لسجلّ مبنى أو شقق.
  • P: صندوق مكتب النشر هذا تطابق مع صندوق بريد.
  • R: مسار ريفي أو عقد طريق مرتفع: يتطابق هذا العنوان مع سجلّ مسار ريفي أو سجل عقد الطريق السريع، وقد يحتوي كلاهما على نطاقات أرقام صناديق مرتبطة.
  • S: سجل الشارع: يتطابق هذا الحقل مع سجل شارع يحتوي على نطاق رقم أساسي صالح.
default_address

bool

مؤشر على أنّه تم العثور على عنوان تلقائي، ولكن هناك عناوين أكثر تحديدًا.
error_message

string

رسالة خطأ لاسترداد بيانات USPS. تتم تعبئة هذا الحقل عند تعليق معالجة خدمة USPS بسبب رصد عناوين تم إنشاؤها بشكل مصطنع.

قد لا تتم تعبئة حقول بيانات USPS عند ظهور هذا الخطأ.
cass_processed

bool

مؤشر على اكتمال معالجة الطلب CASS

ValidateAddressRequest

تمثّل هذه السمة طلب التحقّق من صحة عنوان.

الحقول
address

PostalAddress

مطلوبة. العنوان الذي يتم التحقق من صحته. يجب إرسال العناوين غير المنسَّقة عبر address_lines.

يجب ألا يتجاوز إجمالي طول الحقول في هذا الإدخال 280 حرفًا.

يمكن الاطّلاع هنا على المناطق التي يتوفّر فيها التطبيق.

القيمة language_code في عنوان الإدخال محجوزة للاستخدامات المستقبلية ويتم تجاهلها اليوم. ستتم تعبئة نتيجة العنوان الذي تم التحقّق منه بناءً على اللغة المفضّلة للعنوان المحدَّد، كما يحدّدها النظام.

تتجاهل واجهة برمجة تطبيقات التحقق من صحة العناوين القيم في recipients وorganization. وسيتم تجاهل أي قيم في هذه الحقول ولن يتم عرضها. يُرجى عدم ضبطها.
previous_response_id

string

يجب أن يكون هذا الحقل فارغًا لطلب التحقّق من العنوان الأول. إذا كانت هناك حاجة إلى المزيد من الطلبات للتحقّق من صحة عنوان واحد بالكامل (على سبيل المثال، إذا كانت التغييرات التي يجريها المستخدم بعد عملية التحقّق الأولية بحاجة إلى إعادة التحقّق)، يجب عندئذٍ كل طلب متابعة تعبئة هذا الحقل بـ response_id من الاستجابة الأولى في تسلسل التحقّق.
enable_usps_cass

bool

لتفعيل الوضع المتوافق مع معيار USPS CASS. يؤثر هذا فقط في الحقل google.maps.addressvalidation.v1.ValidationResult.usps_data في google.maps.addressvalidation.v1.ValidationResult. ملاحظة: بالنسبة إلى الطلبات التي تستخدم خدمة USPS CASS للعناوين في بورتوريكو، يجب تقديم google.type.PostalAddress.region_code من address على أنه "PR"، أو يجب تقديم google.type.PostalAddress.administrative_area من address على أنه "بورتوريكو" (غير حساس لحالة الأحرف) أو "PR".

يوصى باستخدام address مكون من مكوّنات، أو بدلاً من ذلك تحديد google.type.PostalAddress.address_lines على الأقل حيث يحتوي السطر الأول على رقم الشارع واسمه، ويحتوي السطر الثاني على المدينة والولاية والرمز البريدي.
language_options

LanguageOptions

اختياريّ. المعاينة: تتوفّر هذه الميزة في مرحلة المعاينة (ما قبل التوفّر للجمهور العام). قد يتوفّر دعم محدود للمنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام، وقد لا تتوافق التغييرات في المنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة في مرحلة ما قبل التوفّر للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مرحلة الإطلاق.

لتفعيل واجهة برمجة تطبيقات التحقق من صحة العنوان الجغرافي لتضمين معلومات إضافية في الرد.
session_token

string

اختياريّ. سلسلة تحدد جلسة الإكمال التلقائي لأغراض الفوترة. يجب أن يكون عنوان URL واسم ملف آمن وسلسلة base64 لا يزيد طولها عن 36 حرف ASCII. وخلاف ذلك، يتم عرض خطأ ضياء_فياكن.

تبدأ الجلسة عندما يُجري المستخدم طلب بحث الإكمال التلقائي، وتنتهي عندما يختار مكانًا ويُجري اتصال بيانات لتفاصيل المكان أو التحقُّق من صحة العنوان. يمكن أن تحتوي كل جلسة على طلبات بحث متعددة للإكمال التلقائي، متبوعة بطلب واحد لتفاصيل المكان أو طلب التحقق من صحة العنوان. يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب خلال جلسة إلى المشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يصبح الرمز المميّز صالحًا، بل يجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة. إذا تم حذف مَعلمة sessionToken أو إذا أعدت استخدام رمز مميَّز للجلسة، يتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب على حدة).

ملاحظة: يمكن استخدام "التحقق من صحة العنوان" في الجلسات فقط مع واجهة برمجة تطبيقات الإكمال التلقائي (الجديدة)، وليس واجهة برمجة التطبيقات الخاصة بميزة "الإكمال التلقائي". يمكنك الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/session-pricing للحصول على مزيد من التفاصيل.

ValidateAddressResponse

تمثّل هذه السمة الاستجابة لطلب التحقّق من العنوان.

الحقول
result

ValidationResult

هي نتيجة التحقّق من العنوان.
response_id

string

المعرّف الفريد العالمي (UUID) الذي يعرّف هذه الاستجابة وإذا كانت هناك حاجة إلى إعادة إثبات صحة العنوان، يجب أن يكون المعرّف الفريد العالمي هذا مع الطلب الجديد.

ValidationResult

هي نتيجة التحقّق من صحة عنوان.

الحقول
verdict

Verdict

الإبلاغات العامة عن البيان
address

Address

معلومات حول العنوان نفسه وليس الرمز الجغرافي.
geocode

Geocode

معلومات عن الموقع الجغرافي والمكان الذي تم ترميز العنوان جغرافيًا إليه
metadata

AddressMetadata

تمثّل هذه السمة معلومات أخرى ذات صلة بالتسليم. ليس من المضمون تعبئة metadata بالكامل لكل عنوان يتم إرساله إلى واجهة برمجة تطبيقات التحقُّق من صحة العناوين.
usps_data

UspsData

علامات تسليم إضافية مقدمة من USPS. يتوفّر هذا العرض فقط في المنطقتين US وPR.
english_latin_address

Address

المعاينة: تتوفّر هذه الميزة في مرحلة المعاينة (ما قبل التوفّر للجمهور العام). قد يتوفّر دعم محدود للمنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام، وقد لا تتوافق التغييرات في المنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة في مرحلة ما قبل التوفّر للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مرحلة الإطلاق.

تمت ترجمة العنوان إلى الإنجليزية.

لا يمكن إعادة استخدام العناوين المترجَمة كإدخال في واجهة برمجة التطبيقات. توفِّر الخدمة للمستخدمين إمكانية استخدام لغتهم الأم لتأكيد صحة العنوان المقدَّم في الأصل أو رفضه.

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

يمكنك تفعيل هذا الإخراج باستخدام علامة google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

ملاحظة: لا تتم تعبئة الحقل google.maps.addressvalidation.v1.Address.unconfirmed_component_types في الحقل english_latin_address والحقل google.maps.addressvalidation.v1.AddressComponent.confirmation_level في english_latin_address.address_components.

النتيجة

نظرة عامة عالية المستوى على نتيجة التحقّق من العنوان والرمز الجغرافي

الحقول
input_granularity

Granularity

دقة عنوان الإدخال. هذه نتيجة تحليل عنوان الإدخال ولا تقدِّم أي إشارات تحقُّق. للحصول على إشارات التحقّق، يُرجى الاطّلاع على validation_granularity أدناه.

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

Granularity

مستوى الدقّة الذي يمكن لواجهة برمجة التطبيقات validate من العنوان إليه بشكل كامل. على سبيل المثال، يشير validation_granularity لـ PREMISE إلى أنّه يمكن التحقّق من جميع مكوّنات العنوان على مستوى PREMISE أو مستوى أعلى منه.

يمكن العثور على نتيجة التحقّق من مكوِّنات لكل عنوان في google.maps.addressvalidation.v1.Address.address_components.
geocode_granularity

Granularity

تمثّل هذه السمة معلومات عن درجة دقة geocode. ويمكن فهم ذلك على أنه المعنى الدلالي لمدى تدرجه أو دقته في الموقع الجغرافي المرمَّز جغرافيًا.

قد يختلف هذا التصنيف عن validation_granularity أعلاه في بعض الأحيان. على سبيل المثال، قد تسجل قاعدة البيانات لدينا وجود رقم شقة ولكنها لا تحتوي على موقع دقيق للشقة داخل مجمع سكني كبير. وفي هذه الحالة، ستكون قيمة validation_granularity هي SUB_PREMISE لكن قيمة geocode_granularity ستكون PREMISE.
address_complete

bool

يُعتبر العنوان مكتملاً إذا لم تكن هناك رموز مميزة لم يتم حلها أو لم تكن هناك مكونات عنوان غير متوقعة أو مفقودة. وفي حال ترك هذه السياسة بدون ضبط، تتم الإشارة إلى أنّ القيمة هي false. يُرجى الاطّلاع على الحقول "missing_component_types" أو "unresolved_tokens" أو "unexpected" للحصول على مزيد من التفاصيل.
has_unconfirmed_components

bool

لا يمكن تصنيف مكوّن عنوان واحد على الأقل أو التحقّق من صحته، ويمكنك الاطّلاع على google.maps.addressvalidation.v1.Address.address_components للحصول على التفاصيل.
has_inferred_components

bool

تم استنتاج (إضافة) مكوّن عنوان واحد على الأقل غير موجود في الإدخال. لمزيد من التفاصيل، يُرجى الاطّلاع على google.maps.addressvalidation.v1.Address.address_components.
has_replaced_components

bool

تم استبدال مكوّن عنوان واحد على الأقل. يُرجى الاطّلاع على google.maps.addressvalidation.v1.Address.address_components لمعرفة التفاصيل.

درجة الدقة

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

عمليات التعداد
GRANULARITY_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
SUB_PREMISE نتيجة مستوى مبنى أسفل المبنى، مثل شقة
PREMISE نتيجة على مستوى البنية
PREMISE_PROXIMITY رمز جغرافي يقارب الموقع الجغرافي للعنوان على مستوى المبنى
BLOCK يشير العنوان أو الرمز الجغرافي إلى الكتلة. تُستخدم فقط في المناطق التي لديها عناوين على مستوى الحظر، مثل اليابان.
ROUTE يُعد الرمز الجغرافي أو العنوان دقيقًا عند تحديد المسار، مثل شارع أو طريق أو طريق سريع.
OTHER جميع درجات الدقة الأخرى، التي يتم تجميعها معًا نظرًا لأنها غير قابلة للتسليم.