Local photon instances — with

Evaluate R code with a photon instance without changing the active photon mount.

Usage

with_photon(photon, code)

Arguments

photon: An object of class photon that is temporarily mounted to the session.
code: Code to execute in the temporary environment.

Value

The results of the evaluation of the code argument.

Examples

# Get a public instance
pub_photon <- new_photon()

# Mount a custom instance
new_photon(url = "https://localhost:8001/")
#> <photon>
#>   Type   : remote
#>   Server : https://localhost:8001/

# Geocode with the public instance only once
with_photon(pub_photon, geocode("Rutland"))
#> Simple feature collection with 1 feature and 11 fields
#> Geometry type: POINT
#> Dimension:     XY
#> Bounding box:  xmin: -0.6632643 ymin: 52.6423 xmax: -0.6632643 ymax: 52.6423
#> Geodetic CRS:  WGS 84
#> # A tibble: 1 × 12
#>     idx osm_type osm_id osm_key  osm_value type  countrycode name  country state
#>   <int> <chr>     <int> <chr>    <chr>     <chr> <chr>       <chr> <chr>   <chr>
#> 1     1 R         57398 boundary administ… coun… GB          Rutl… United… Engl…
#> # ℹ 2 more variables: extent <list>, geometry <POINT [°]>

# The custom instance is still mounted
get_instance()
#> <photon>
#>   Type   : remote
#>   Server : https://localhost:8001/