campfin (version 1.0.7)

normal_address: Normalize street addresses

Description

Return consistent version of a US Street Address using stringr::str_*() functions. Letters are capitalized, punctuation is removed or replaced, and excess whitespace is trimmed and squished. Optionally, street suffix abbreviations ("AVE") can be replaced with their long form ("AVENUE"). Invalid addresses from a vector can be removed (possibly using invalid_city) as well as single (repeating) character strings ("XXXXXX").

Usage

normal_address(address, abbs = NULL, na = c("", "NA"), na_rep = FALSE)

Arguments

address

A vector of street addresses (ideally without city, state, or postal code).

abbs

A named vector or two-column data frame (like usps_street) passed to expand_abbrev(). See ?expand_abbrev for the type of object structure needed.

na

A character vector of values to make NA (like invalid_city).

na_rep

logical; If TRUE, replace all single digit (repeating) strings with NA.

Value

A vector of normalized street addresses.

See Also

Other geographic normalization functions: abbrev_full(), abbrev_state(), check_city(), expand_abbrev(), expand_state(), fetch_city(), normal_city(), normal_state(), normal_zip(), str_normal()

Examples

# NOT RUN {
normal_address("P.O. 123, C/O John Smith", abbs = usps_street)
normal_address("12east 2nd street, suite209", abbs = usps_street)
# }