Finds and downloads the Elasticsearch index database necessary to set up Photon locally.
Usage
download_searchindex(
path = ".",
country = "Monaco",
date = "latest",
exact = FALSE,
section = NULL,
only_url = FALSE,
quiet = FALSE
)
Arguments
- path
Path to a directory where the identified file should be stored.
- country
Character string that can be identified by
countryname
as a country. An extract for this country will be downloaded. If"planet"
, downloads a global search index.- date
Character string or date-time object used to specify the creation date of the search index. If
"latest"
, will download the file tagged with "latest". If a character string, the value should be parseable byas.POSIXct
. Ifexact = FALSE
, the input value is compared to all available dates and the closest date will be selected. Otherwise, a file will be selected that exactly matches the input todate
.- exact
If
TRUE
, exactly matches thedate
. Otherwise, selects the date with lowest difference to thedate
parameter.- section
Subdirectory of the download server from which to select a search index. If
"experimental"
, selects a dump made for the master version of photon. If"archived"
, selects a dump made for an older version of photon. IfNULL
, selects a dump made for the current release. Defaults toNULL
.- only_url
If
TRUE
, performs a download. Otherwise, only returns a link to the file.- quiet
If
TRUE
, suppresses all informative messages.
Value
If only_url = FALSE
, returns the local path to the downloaded
file. Otherwise, returns the URL to the remote file.
Note
Depending on the country, search index databases tend to be very large. The global search index is about 75 GB of size (10/2024). Keep that in mind when running this function.
Examples
# download the latest extract of Monaco
download_searchindex(path = tempdir())
#> ℹ Fetching search index for Monaco, created on latest
#> ✔ Successfully downloaded search index. [2.2s]
#>
#> [1] "/tmp/RtmpFN470Q/photon-db-mc-latest.tar.bz2"
# download the latest extract of American Samoa
download_searchindex(path = tempdir(), country = "Samoa")
#> ℹ Fetching search index for Samoa, created on latest
#> ✔ Successfully downloaded search index. [281ms]
#>
#> [1] "/tmp/RtmpFN470Q/photon-db-ws-latest.tar.bz2"
# download an extract from a month ago
download_searchindex(
path = tempdir(),
country = "Monaco",
date = Sys.time() - 2629800
)
#> ℹ Fetching search index for Monaco, created on 2024-11-10
#> ✔ Successfully downloaded search index. [203ms]
#>
#> [1] "/tmp/RtmpFN470Q/photon-db-mc-241110.tar.bz2"
# if possible, download an extract from today
try(download_searchindex(
path = tempdir(),
country = "Monaco",
date = Sys.Date(),
exact = TRUE
))
#> Error in download_searchindex(path = tempdir(), country = "Monaco", date = Sys.Date(), :
#> ! Specified `date` does not match any available dates.
#> ℹ Consider setting `exact = FALSE`.
# get the latest global coverage
# NOTE: the file to be downloaded is several tens of gigabytes of size!
if (FALSE) { # \dontrun{
download_searchindex(path = tempdir(), country = "planet")} # }