NEWS

photon 1.0.0 (2026-02-28)

Adjusts to changes in version 1.0.0 of photon geocoder

structured() geocoding does not require special setups anymore
download_database() is adjusted for the new interface of the download server.
list_regions() provides an overview of possible regions for download_database()
Add $status() method that interfaces new /status endpoint
Deprecate date, exact, and section arguments in download_database() without replacement
Deprecate country argument in download_database() in favor of region
Deprecate structured, update, and enable_update_api arguments in $import(). Use photon_opts for older versions of the photon geocoder.

Add support for unpacking and importing JSON dumps in $import()
Automatically convert countries to countrycodes in .data argument of structured()
Add new API parameters dedupe, inlude, and exclude as function arguments
Fix progress bar termination condition in structured()
Align behavior of $import() with $start() more consistently
Adjust log parsing of $start() and $import() to new format
$is_ready() now uses new /status endpoint
Add new subsection on JSON dump imports to vignette

Increment photon version to 0.7.4
Match package version to photon version
Update examples to work in photon 0.7.4
Set photon 0.7.4 as default and add a supersede warning if version < 0.7.0
Add photon type (OpenSearch/ElasticSearch) to error message
Adjust geocoding error detection to OpenSearch
Update vignettes to OpenSearch
Switch from Samoa to Monaco as example country (more reliable)
Add mount argument to new_photon(). If FALSE, instance is created but not mounted.
Add function with_photon() to execute code using a local photon instance
Add extra info to HTTP404 when search index download does not yield a result
Add $help() method to show raw argument information from jar file
Add CRS checks and transformations when an sf geometry is provided to reverse()
Improve URL checker by relying on httr2::url_parse()
Fix $download_data() method not untaring archive and storing metadata
Fix error detection during setup when encountering an exception without a timestamp
Fix error detection not recognizing OpenSearch import errors
Fix path arguments defaulting to "."
Fix an example in new_photon()
Fix progress bar in reverse()
Purge photon instances after examples