Valida una dirección

Para validar una dirección con la API de Address Validation en la API de Maps JavaScript, llama al método fetchAddressValidation y pasa un cuerpo de solicitud con la dirección que se validará, como se muestra en el siguiente ejemplo.

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

Puedes definir una dirección con componentes individuales o con addressLines para pasar toda la dirección con formato como un literal de array (la API analizará la dirección en componentes individuales):

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

Cómo controlar los resultados

El método fetchAddressValidation devuelve una promesa que se resuelve en un objeto AddressValidationResponse. Este objeto contiene la dirección validada, incluidas las correcciones que realizó la API. Puedes acceder a los distintos campos del objeto de respuesta para determinar el estado de validación de la dirección. En el siguiente ejemplo, se muestra cómo acceder a los campos del objeto de respuesta.

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

Próximos pasos