Valider une adresse

Pour valider une adresse à l'aide de l'API Address Validation dans l'API Maps JavaScript, appelez la méthode fetchAddressValidation en transmettant un corps de requête avec l'adresse à valider, comme indiqué dans l'exemple suivant. 

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, '  ');
}

Vous pouvez définir une adresse à l'aide de composants individuels ou à l'aide de addressLines pour transmettre l'adresse formatée complète en tant que littéral de tableau (l'API analysera l'adresse en composants individuels):

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

Gérer les résultats

La méthode fetchAddressValidation renvoie une promesse qui se résout en objet AddressValidationResponse. Cet objet contient l'adresse validée, y compris les corrections apportées par l'API. Vous pouvez accéder aux différents champs de l'objet de réponse pour déterminer l'état de validation de l'adresse. L'exemple suivant montre comment accéder aux champs de l'objet de réponse. 

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

Étapes suivantes