API & data

Clean up an address without losing useful details

A normalized address helps matching, but delivery instructions still need to remain available.

Keep the original input

Before replacing an address with a suggestion, retain the received version in your working document. Compare the building number, street, postal code, and city. A plausible result may identify the right street with the wrong number. The goal is easier comparison, not hiding differences.

Separate address and instructions

In a fictional example, “building B, courtyard entrance” helps the driver find the door. Do not lose that detail because a lookup returns only the main street. Separate the geographic address from practical instructions, then ask the recipient to confirm ambiguous details.

Review before processing in bulk

First test representative rows: short addresses, additional details, and nearby cities. Review differences before applying the process to the rest of the file. Normalization does not guarantee that a location accepts mail or deliveries.

Checklist

  • Keep the original version
  • Preserve additional details
  • Check a varied sample

Primary sources