NEWS.md

In photon: High-Performance Geocoding using 'photon'

photon 1.0.0

Adjusts to changes in version 1.0.0 of photon geocoder

Major changes

• 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.

Minor changes

• 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

photon 0.7.4-1

• Adjusted tests and examples to be more resilient to server outages

photon 0.7.4

• 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

photon 0.3.5

• Set limit = 1 as default (#2)
• Increment photon version number
• Document lang = "default" (#8)
• Allow osm_tags and layer arguments to take vectors of length > 1 (#7)
• Fix typos and old info in documentation (#4)
• Add current date to metadata if search index is tagged as "latest" (#5)
• Fix typo in range assertion (#9)
• Add details to HTTP error messages (#6)
• Improve performance by querying duplicates only once (#10)
• Always keep number of rows from original dataset (#3)
• Fix broken ps command on newer Linux versions
• Made setups more stable by splitting logs (#11, #12)
• Handle NA as argument input more elegantly
• Added optional latinization
• Renamed consent argument of purge_java() to ask

photon 0.3.1

• Initial CRAN submission.

photon documentation built on April 10, 2026, 5:07 p.m.