یک آدرس را تأیید کنید

برای اعتبارسنجی یک آدرس با استفاده از 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 یک promise را برمی‌گرداند که به یک شیء 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}`);
}
    

مراحل بعدی

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