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

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

• validateAddress (REST)
• ValidateAddress (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 — مطلوبة. يشير هذا المصطلح إلى صفيف يتضمّن عناوين تصف بنية العنوان.

خيار USPS CASSTM

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

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

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

جرّب الآن

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

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

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

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

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

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