Provides access to the oneline single address geocoding API from the US Census Bureau. This can be used with an address that is not parsed.

cxy_oneline(
  address,
  return = "locations",
  benchmark = "Public_AR_Current",
  vintage = NULL
)

Arguments

address

String containing a single line address

return

One of 'locations' or 'geographies' See Details.

benchmark

Optional ID or Name of Census Benchmark. See Details.

vintage

Optional ID or Name of Census Vintage. See Details.

Value

A data.frame containing matched address or NULL if not matches

Details

To obtain current valid benchmarks, use the cxy_benchmarks() function.

If you want to append census geographies, you must specify a valid vintage for your benchmark. You may use the cxy_vintages() function to obtain valid Vintages. See vignette('censusxy') for a full walkthrough.

Examples

# \donttest{
cxy_oneline(address = "20 N Grand Blvd, St Louis, MO 63108", return = "locations")
#>   tigerLine.side tigerLine.tigerLineId coordinates.x coordinates.y
#> 1              R             107607932     -90.23324      38.63593
#>   addressComponents.zip addressComponents.streetName addressComponents.preType
#> 1                 63103                        GRAND                          
#>   addressComponents.city addressComponents.preDirection
#> 1            SAINT LOUIS                              N
#>   addressComponents.suffixDirection addressComponents.fromAddress
#> 1                                                               2
#>   addressComponents.state addressComponents.suffixType
#> 1                      MO                         BLVD
#>   addressComponents.toAddress addressComponents.suffixQualifier
#> 1                         298                                  
#>   addressComponents.preQualifier                          matchedAddress
#> 1                                20 N GRAND BLVD, SAINT LOUIS, MO, 63103
# }