ارسال درخواست اعتبارسنجی نشانی

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

با ارسال درخواست پست به یکی از نقاط پایانی زیر، درخواست اعتبارسنجی نشانی ارسال کنید:

درخواست شما باید یک بدنه درخواست 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"]
  },
}

APIs Explorer به شما امکان می‌دهد درخواست‌های زنده ایجاد کنید تا بتوانید با API و گزینه‌های API آشنا شوید:

فیلدهای درخواست نشانی

متن درخواست شامل یک فیلد است:

  • address — فیلدی از نوع PostalAddress که باید حداقل یک ورودی در addressLines داشته باشد.

هنگام ارسال فیلد address به Address Validation API، فقط باید یک فیلد را ارائه دهید: addressLines. بااین‌حال، ساده‌ترین درخواست نشانی باید شامل زیرفیلدهای زیر باشد:

  • regionCode — توصیه می‌شود. این فیلد اختیاری است، اما اگر حذف شود، Address Validation API منطقه را از نشانی استنباط می‌کند. بااین‌حال، برای بهترین نتایج، اگر regionCode را می‌دانید، آن را اضافه کنید. برای فهرست مناطق پشتیبانی‌شده، به مناطق پشتیبانی‌شده مراجعه کنید.
  • addressLines — الزامی. آرایه‌ای با نشانی‌هایی که ساختار پایین‌تر نشانی را توصیف می‌کند.
PostalAddress را در راهنمای مرجع ببینید.

گزینه USPS CASS™‎

«سرویس پستی ایالات متحده» (USPS®)۱ سیستم پشتیبانی دقت کدگذاری (CASS™) را برای پشتیبانی و تأیید ارائه‌دهندگان اعتبارسنجی نشانی نگهداری می‌کند.

فقط برای مناطق ایالات متحده و پورتوریکو، می‌توانید پردازش CASS را با تنظیم کردن enableUspsCass روی true در بدنه درخواست فعال کنید. برای دریافت بهترین نتایج هنگام استفاده از CASS، نشانی‌ای ارائه دهید که شامل خیابان و شماره خیابان به‌همراه شهر، ایالت، و کد پستی باشد:

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

امتحان کنید!

با API Explorer می‌توانید درخواست‌های نمونه ایجاد کنید تا با API و گزینه‌های API آشنا شوید.

  1. نماد API api را در سمت چپ صفحه انتخاب کنید.

  2. درصورت تمایل، پارامترهای درخواست را ویرایش کنید.

  3. دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که می‌خواهید برای ارسال درخواست استفاده شود انتخاب کنید.

  4. در پانل «کاوشگر API»، نماد تمام‌صفحه تمام‌صفحه را انتخاب کنید تا پنجره «کاوشگر API» ازهم باز شود.

  1. ‫Google Maps Platform دارنده پروانه غیرانحصاری United States Postal Service®‎ است. علامت(های) تجاری زیر متعلق به United States Postal Service®‎ است و با اجازه آن استفاده می‌شود: United States Postal Service®‎،‏ CASS™‎،‏ CASS Certified™‎. ↩