Package google.maps.addressvalidation.v1

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الفهرس

التحقق من صحة العنوان

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

تقديم ملاحظات وآراء

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

تعليقات حول نتيجة تسلسل محاولات التحقق. يجب أن تكون هذه المكالمة الأخيرة التي يتم إجراؤها بعد سلسلة من مكالمات التحقق من صحة العنوان نفسه، ويجب أن يتم استدعاؤها بعد الانتهاء من المعاملة. يجب إرسال هذا مرة واحدة فقط لتسلسل 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 الشارع الرئيسي، سان فرانسيسكو، كاليفورنيا، 94105"، قد تبدو الرموز المميزة التي لم يتم حلها كـ ["123235253253"] نظرًا لأنها لا تبدو كرقم شارع صالح.

مكوّن العنوان

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

الحقول
component_name

ComponentName

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

string

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

ConfirmationLevel

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

bool

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

bool

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

bool

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

bool

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

مستوى التأكيد

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

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

بيانات وصفية للعنوان

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

الحقول
business

bool

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

bool

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

bool

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

اسم المكوّن

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

الحقول
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'] يمكن العثور على القائمة الكاملة بالأنواع هنا.

رمز الموقع المفتوح

رمز الموقع المفتوح (http://plus.codes) هو مرجع موقع بتنسيقين: رمز عام يحدد 14mx14m (1/8000th of a degrees) أو مستطيل صغير، ورمزًا مركبًا، ويستبدل البادئة بموقع مرجعي.

الحقول
global_code

string

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

string

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

تقديم طلب التحقق من صحة التعليقات

طلب إرسال تعليقات التحقُّق.

الحقول
conclusion

ValidationConclusion

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

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

string

مطلوبة. رقم تعريف الاستجابة التي تتعلق بها هذه التعليقات. يجب أن تكون الاستجابة [response_id][google.maps.addressvalidation.v1.ValidAddressRequest.response_id] من الاستجابة الأولى في سلسلة من محاولات التحقق من العنوان.

خاتمة التحقّق

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

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

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

تمثل هذه الخاصية ردًا على تعليقات التحقق من الصحة.

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

عنوان USps

تمثيل 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.

بيانات USps

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

الحقول
standardized_address

UspsAddress

عنوان USPS القياسي.
delivery_point_code

string

رمز نقطة التسليم المكوّن من رقمين
delivery_point_check_digit

string

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

string

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

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

string

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

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

string

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

  • Y: العنوان هو CMRA
  • N: العنوان ليس CMRA.
dpv_vacant

string

هل هذا المكان شاغر؟ لعرض حرف واحد.

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

string

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

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

string

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

البادئات:

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

string

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

bool

عنوان التسليم متطابق، ولكن يشير ملف 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 تصاعدي/تنازلي (أ/د).
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

مؤشر على أنه قد تمت معالجة طلب CAS.

طلب التحقق من العنوان

طلب التحقق من صحة عنوان.

الحقول
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 على الأقل حيث يحتوي السطر الأول على رقم الشارع والاسم ويحتوي السطر الثاني على المدينة والولاية والرمز البريدي.

التحقق من صحة استجابة العنوان

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

الحقول
result

ValidationResult

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

string

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

نتيجة التحقق

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

الحقول
verdict

Verdict

علامات القرار العام
address

Address

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

Geocode

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

AddressMetadata

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

UspsData

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

النتيجة

نظرة عامة عالية المستوى على نتيجة التحقق من العنوان والشكل الجغرافي.

الحقول
input_granularity

Granularity

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

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

Granularity

مستوى الدقة الذي يمكن لواجهة برمجة التطبيقات التحقق من العنوان بالكامل إليه. على سبيل المثال، يشير 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

يُعتبر العنوان مكتملاً إذا لم تكن هناك رموز مميزة لم تُحَل، ولم تكن هناك مكونات عنوان غير متوقعة أو مفقودة. يمكنك الاطّلاع على الحقول 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" في "ريدوود سيتي"، قد يكون الترميز الجغرافي المعروض دقيقًا بنسبة LOCALITY على الرغم من أن العنوان أكثر دقة.

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