إرسال طلب التحقق من العنوان

أرسِل طلبًا للتحقّق من العنوان من خلال إرسال طلب POST إلى إحدى نقاط النهايات التالية:

• validateAddress (REST)
• ValidateAddress (gRPC)

ملاحظة: يستخدم هذا المستند REST كأمثلة، ولكن النهج المتشابه مشابه. باستخدام gRPC.

يجب أيضًا أن ينقل طلبك نص طلب JSON إلى الطلب الذي العنوان المراد التحقق من صحته. يحتوي نص الطلب التالي على حقل واحد وثلاثة حقول فرعية:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

يمكنك أيضًا حذف locality وتحديدها كعنصر في صفيف addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

جرِّبه الآن

حقول طلب العناوين

يتألف نص الطلب من حقل واحد:

• address — حقل من النوع PostalAddress، والذي يجب أن يحتوي على إدخال واحد على الأقل في addressLines.

عند إرسال الحقل address إلى واجهة برمجة تطبيقات التحقق من صحة العنوان، ستحتاج فقط إلى أدخِل حقلاً واحدًا: addressLines. ومع ذلك، فإن أبسط طلبات العنوان على الحقول الفرعية التالية:

• regionCode: يُنصح به. يعد هذا حقلاً اختياريًا، ولكن إذا تم حذفه، تستنتج واجهة برمجة تطبيقات التحقق من صحة العنوان المنطقة من العنوان. ومع ذلك، بالنسبة لأفضل ، قم بتضمين regionCode إذا كنت تعرفها. للحصول على قائمة بالمناطق التي تتوفّر فيها هذه الميزة، يُرجى الرجوع إلى المناطق التي تتوفّر فيها الميزة.
• addressLines — مطلوبة. يشير هذا المصطلح إلى صفيف يتضمّن عناوين تصف بنية العنوان.

اطّلِع على PostalAddress في الدليل المرجعي.

خيار USPS CASSTM

تحتفظ ®USPS® (USPS®) التابعة للولايات المتحدة¹ بـ نظام دعم دقة الترميز (CASSTM) للدعم والاعتماد التحقق من العنوان.

ملاحظة: تم تأكيد واجهة برمجة تطبيقات التحقق من صحة العنوان كخدمة CASS-CertifiedTM. وهذا يعني أنّ الخدمة تم تأكيدها لقدرتها على ملء معلومات العنوان المفقودة وتوحيدها وتعديلها إلى العنوان الأكثر حداثة ودقة.

في منطقتَي الولايات المتحدة والمقاطعة البرتغالية فقط، يمكنك تفعيل معالجة CASS من خلال ضبط قيمة enableUspsCass على true في نص الطلب. للحصول على أفضل النتائج عند استخدام CASS، قم بتقديم عنوان يتضمن رقم الشارع ورقم الشارع بالإضافة إلى المدينة والولاية والرمز البريدي:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

ملاحظة: في حال لم تكن بحاجة إلى معالجة CASS أو إذا كنت تتحقق من صحة البيانات خارج الولايات المتحدة ومناطقها العامة، لا تنصح Google بتفعيل هذه الميزة.

جرّب الآن

يتيح لك "مستكشف واجهات برمجة التطبيقات" تقديم طلبات نموذجية حتى تتمكن من الإلمام بخيارات واجهة برمجة التطبيقات وواجهة برمجة التطبيقات.

1. انقر على رمز واجهة برمجة التطبيقات، ، على الجانب الأيمن من الصفحة.

2. يمكنك اختياريًا توسيع عرض المعلَمات العادية وضبط fields. المَعلمة إلى الحقل كمامة.

3. يمكنك تعديل نص الطلب اختياريًا.

4. انقر على الزر تنفيذ. في مربع الحوار، اختر الحساب الذي تريد استخدامها لتقديم الطلب.

5. في لوحة "مستكشف واجهة برمجة التطبيقات"، حدد رمز التوسيع، ، لتوسيع نافذة مستكشف واجهة برمجة التطبيقات

---

1. "منصة خرائط Google" هي جهة مرخَّص لها بشكل غير حصري في الولايات المتحدة. Postal Service®. العلامات التجارية التالية مملوكة من الولايات المتحدة. Postal Service® ويتم استخدامها بإذن: United States Postal Service® ، CASSTM ، CASS CertificationTM ↩