Download NHD

download_nhd(nhd_dir, hu_list, download_files = TRUE)

Arguments

nhd_dir

character directory to save output into

hu_list

character vector of hydrologic region(s) to download. Use get_huc to find HU codes of interest. Accepts two digit and four digit codes.

download_files

boolean if FALSE, only URLs to files will be returned can be hu02s and/or hu04s

Value

character Paths to geodatabases created.

Examples

# \donttest{
hu <- get_huc(sf::st_sfc(sf::st_point(c(-73, 42)), crs = 4326),
                            type = "huc08")
#> defaulting to 2025 version of WBD
#> GET https://api.water.usgs.gov/fabric/pygeoapi/
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/catchmentsp/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdarea/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdflowline_network/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdflowline_nonnetwork/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdwaterbody/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/gagesii/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/gagesii-basins/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc02/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc04/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc06/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc08/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc10/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplusv2-huc12/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc02/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc04/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc06/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc08/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc10/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/nhdplushr-huc12/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd02_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd04_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd06_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd08_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd10_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd12_20201026/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd02_20250107/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd04_20250107/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd06_20250107/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd08_20250107/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd10_20250107/queryables?f=json
#> GET https://api.water.usgs.gov:443/fabric/pygeoapi/collections/wbd12_20250107/queryables?f=json
#> GET https://api.water.usgs.gov/fabric/pygeoapi/collections/wbd08_20250107/items?bbox=-73.0000073573341,41.9999945892465,-72.9999926426652,42.0000054107534&limit=500&offset=0

(hu <- substr(hu$huc8, 1, 2))
#> [1] "01"

download_nhd(tempdir(), c(hu, "0203"), download_files = FALSE)
#>  [1] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0101_HU4_GDB.zip"
#>  [2] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0102_HU4_GDB.zip"
#>  [3] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0103_HU4_GDB.zip"
#>  [4] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0104_HU4_GDB.zip"
#>  [5] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0105_HU4_GDB.zip"
#>  [6] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0106_HU4_GDB.zip"
#>  [7] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0107_HU4_GDB.zip"
#>  [8] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0108_HU4_GDB.zip"
#>  [9] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0109_HU4_GDB.zip"
#> [10] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0110_HU4_GDB.zip"
#> [11] "https://prd-tnm.s3.amazonaws.com/StagedProducts/Hydrography/NHD/HU4/GDB/NHD_H_0203_HU4_GDB.zip"
# }