Adresse bestätigen

Wenn Sie eine Adresse mit der Address Validation API in der Maps JavaScript API validieren möchten, rufen Sie die Methode fetchAddressValidation auf und übergeben Sie einen Anfragetext mit der zu validierenden Adresse, wie im folgenden Beispiel gezeigt. 

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

Sie können eine Adresse definieren, indem Sie einzelne Komponenten verwenden oder addressLines verwenden, um die gesamte formatierte Adresse als Array-Literal zu übergeben. Die API parst die Adresse dann in einzelne Komponenten:

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

Ergebnisse verarbeiten

Die fetchAddressValidation-Methode gibt ein Promise zurück, das in ein AddressValidationResponse-Objekt aufgelöst wird. Dieses Objekt enthält die validierte Adresse, einschließlich aller von der API vorgenommenen Korrekturen. Sie können auf die verschiedenen Felder des Antwortobjekts zugreifen, um den Validierungsstatus der Adresse zu ermitteln. Das folgende Beispiel zeigt, wie auf die Felder des Antwortobjekts zugegriffen wird. 

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

Nächste Schritte