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