التحقق من صحة العنوان

للتحقّق من صحة عنوان باستخدام خدمة "التحقّق من صحة العناوين" في 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 لتمرير العنوان المنسّق بالكامل كقيمة حرفية للمصفوفة (ستحلّل واجهة برمجة التطبيقات العنوان إلى مكوّنات فردية):

address: {
  addressLines: ['1600 Amphitheatre Parkway, Mountain View, CA 94043'],
}
    

التعامل مع النتائج

يعرض الإجراء fetchAddressValidation وعدًا يتم تنفيذه إلى عنصر AddressValidationResponse. يحتوي هذا العنصر على العنوان الذي تم التحقّق من صحته، بما في ذلك أي تصحيحات أجرتها واجهة برمجة التطبيقات. يمكنك الوصول إلى الحقول المختلفة الخاصة بكائن الرد لتحديد حالة التحقّق من صحة العنوان. يوضّح المثال التالي كيفية الوصول إلى حقول عنصر الرد.

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}`);
}
    

الخطوات التالية

• فهم الرد الأساسي على عملية التحقّق من صحة العنوان