پاسخ اعتبارسنجی آدرس اولیه را درک کنید

پاسخ Address Validation API حاوی این ویژگی های سطح بالا است:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

اموال verdict

ویژگی verdict نتایج اعتبار سنجی آدرس را خلاصه می کند و باید اولین خاصیتی باشد که هنگام ساخت منطق بررسی آدرس، ارزیابی می شود. این ویژگی بسته به کیفیت آدرس خروجی می تواند فیلدهای مختلفی را برگرداند. به عنوان مثال، موارد زیر ویژگی verdict یک آدرس با کیفیت خوب را نشان می دهد که فیلدهای زیر را برای این درخواست خاص برمی گرداند:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

بخش‌های زیر تمام فیلدهای ویژگی verdict را خلاصه می‌کند.

حکم را در راهنمای مرجع ببینید.

جزئیات آدرس

دانه بندی آدرس به سطح جزئیات مورد استفاده در تعیین ویژگی یک آدرس یا ژئوکد اشاره دارد. ویژگی آدرس در پاسخ validationGranularity یک سیگنال کلیدی برای اینکه آیا یک آدرس قابل تحویل است یا خیر است.

ویژگی verdict این سیگنال های گرانولیتی را برمی گرداند:

  • inputGranularity - سطح جزئیات گرفته شده از آدرس ارسال شده به اعتبار سنجی آدرس در Maps JavaScript API را توصیف می کند. سطح جزئیات آدرس در درخواست بر سطح جزئیات آدرس در پاسخ اعتبارسنجی تأثیر می گذارد. به عنوان مثال، آدرسی با inputGranularity زیر PREMISE زیر سطح معمولاً منجر به validationGranularity به سطح PREMISE نمی شود.
  • validationGranularity - سطح جزئیاتی که Address Validation در Maps JavaScript API می تواند آدرس را به طور کامل تأیید کند. در بیشتر موارد، سطح جزئیات PREMISE یا SUB_PREMISE نشان دهنده یک آدرس با کیفیت است که احتمالا قابل تحویل است.
  • geocodeGranularity - سطح جزئیات ژئوکد مرتبط با آدرس را توصیف می کند. به عنوان مثال، سوابق Google ممکن است وجود یک شماره آپارتمان را نشان دهد، اما مکان دقیقی برای آن آپارتمان خاص در یک مجتمع آپارتمانی بزرگ نیست. در آن صورت، validationGranularity SUB_PREMISE است اما geocodeGranularity PREMISE است.
Granularity را در راهنمای مرجع ببینید.

کامل بودن آدرس

حکم، ویژگی addressComplete را به عنوان سیگنالی برای یک آدرس با کیفیت بالا برمی‌گرداند، به این معنی که هیچ مؤلفه گمشده، حل‌نشده یا غیرمنتظره‌ای ندارد:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

هنگامی که آدرس دارای اجزای مفقود، حل نشده یا غیرمنتظره باشد، فیلد روی false تنظیم می شود.

addressComplete در قسمت حکم و آدرس در راهنمای مرجع ببینید.

کیفیت آدرس

تعدادی از فیلدهای ممکن مشکلات اجزای آدرس یا تنظیمات مربوط به آنها را نشان می دهد، مانند اجزای آدرس استنباط شده یا گمشده. به عنوان مثال، ویژگی verdict زیر یک آدرس با اجزای تایید نشده و یک قسمت از دست رفته addressComplete نشان می دهد:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
حکم را در راهنمای مرجع ببینید.

اقدام بعدی احتمالی

فیلد حکم possibleNextAction یک خلاصه تفسیری از پاسخ API را ارائه می‌کند، که به منظور کمک به تعیین یک اقدام احتمالی بعدی برای انجام است. این فیلد از فیلدهای دیگر در پاسخ API مشتق شده است و نباید به عنوان تضمینی برای صحت آدرس یا تحویل پذیری در نظر گرفته شود.

ویژگی های address و addressComponent

ویژگی address ، قالب‌بندی آدرس پردازش‌شده ارائه‌شده در درخواست را به همراه خلاصه‌های آدرس در سطح مؤلفه، از جمله قسمت‌های اشتباه املایی آدرس، قطعات اشتباه جایگزین شده، و قطعات گمشده استنباط شده ارائه می‌کند.

Address در راهنمای مرجع ببینید.

ویژگی addressComponent یک جزء فرعی از address است که فهرست دقیقی از عناصر یا اجزای آدرسی را که Address Validation در Maps JavaScript API پردازش کرده است، ارائه می‌کند. API هر فیلد مؤلفه را با نام، نوع و سطح تأیید آن شناسایی می کند.

addressComponent در راهنمای مرجع ببینید.

ویژگی geocode

ویژگی geocode مکان جغرافیایی کد شده مرتبط با آدرس ورودی را نشان می دهد. این ویژگی جزئیاتی را درباره خود مکان ارائه می دهد، مانند شناسه مکان آن.

Geocode در راهنمای مرجع ببینید.

خاصیت metadata

این ویژگی ممکن است برای هر آدرسی که توسط Address Validation در Maps JavaScript API پردازش می‌شود پر نشود، اما نشان می‌دهد که آدرس از نوع مسکونی، تجاری یا صندوق پستی است.

پوشش Address Validation API و مرجع Address metadata ببینید.

ویژگی uspsData

این ویژگی اطلاعات مفیدی را برای آدرس های پستی ایالات متحده ارائه می دهد. با این حال، تضمین نمی شود که برای هر آدرسی که توسط سرویس تأیید شده است، به طور کامل پر شود. به همین دلیل، شما نباید به این ویژگی به عنوان تنها وسیله اعتبارسنجی آدرس ها اعتماد کنید، بلکه باید verdict و address نیز بررسی کنید.

به آدرس های ایالات متحده و مرجع USPSData رسیدگی کنید.