للتحقّق من صحة عنوان باستخدام ميزة "التحقّق من العنوان" في 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}`); }