برای تأیید اعتبار یک آدرس با استفاده از Address Validation در Maps JavaScript API، روش fetchAddressValidation
را فراخوانی کنید که یک بدنه درخواست را با آدرسی که باید اعتبارسنجی شود ارسال می کند، همانطور که در مثال زیر نشان داده شده است.
async function validateAddress() { // Import the Address Validation library. const {AddressValidation} = await google.maps.importLibrary('addressValidation'); // Call the fetchAddressValidation method. const result = await AddressValidation.fetchAddressValidation({ address: { postalCode: '94043', regionCode: 'US', languageCode: 'en', addressLines: ['1600 Amphitheatre', 'Parkway'], } }); // Log the results to the console. document.querySelector('pre').textContent = JSON.stringify(result, null, ' '); }
میتوانید با استفاده از مؤلفههای جداگانه، یا با استفاده از addressLines
برای ارسال کل آدرس فرمتشده بهعنوان یک آرایه، یک آدرس تعریف کنید (API آدرس را به اجزای جداگانه تجزیه میکند):
address: { addressLines: ['1600 Amphitheatre Parkway, Mountain View, CA 94043'], }
به نتایج رسیدگی کنید
متد fetchAddressValidation
وعده ای را برمی گرداند که به یک شی AddressValidationResponse
حل می شود. این شی حاوی آدرس تایید شده، از جمله اصلاحات انجام شده توسط API است. برای تعیین وضعیت اعتبار سنجی آدرس می توانید به فیلدهای مختلف شی پاسخ دسترسی داشته باشید. مثال زیر نحوه دسترسی به فیلدهای شیء پاسخ را نشان می دهد.
async function validateAddress() { // Import the Address Validation library. const {AddressValidation} = await google.maps.importLibrary('addressValidation'); // Call the fetchAddressValidation method. const result = await AddressValidation.fetchAddressValidation({ address: { postalCode: '94043', regionCode: 'US', languageCode: 'en', addressLines: ['1600 Amphitheatre', 'Parkway'], } }); // Log the results to the console: console.log(`Formatted address: ${result.address.formattedAddress}`); console.log(`Entered: ${result.verdict.inputGranularity}`); console.log(`Validated: ${result.verdict.validationGranularity}`); console.log(`Address complete: ${result.verdict.addressComplete}`); console.log(`Has unconfirmed components: ${result.verdict.hasUnconfirmedComponents}`); console.log(`Has inferred components: ${result.verdict.hasInferredComponents}`); console.log(`Has replaced components: ${result.verdict.hasReplacedComponents}`); }