Address Command Reference

photo-cli address takes a single photo file, reads its GPS coordinates from EXIF data, sends them to your chosen reverse geocode provider, and prints the resulting address to the console. Use this command to verify that your provider configuration is correct and to discover which property names or admin levels to pass to --openstreetmap-properties, --bigdatacloud-levels, or --googlemaps-types before running photo-cli copy or photo-cli archive across your entire collection.

Synopsis

photo-cli address [options]

Arguments

Required

string

required

Path to the photo file whose GPS coordinates you want to resolve. Only a single file is accepted.

enum

required

Controls how much detail is returned from the provider.

Name	Value	Description
AllAvailableProperties	0	Returns every address property available for the photo’s coordinates
SelectedProperties	1	Returns only the properties you specify via the provider-specific argument
FullResponse	2	Returns the complete raw JSON response from the provider

Optional

enum

Third-party provider used to resolve GPS coordinates. See reverse geocoding overview for setup details.

Name	Value
Disabled (default)	0
BigDataCloud	1
OpenStreetMapFoundation	2
GoogleMaps	3
LocationIq	5

string

Space-separated OpenStreetMap address property names to include in the output. Used when --reverse-geocode is OpenStreetMapFoundation or LocationIq and --type is SelectedProperties.

string

Space-separated BigDataCloud admin level numbers. Used when --reverse-geocode is BigDataCloud and --type is SelectedProperties.

string

API key for BigDataCloud. Also configurable via the PHOTO_CLI_BIG_DATA_CLOUD_API_KEY environment variable.

string

Space-separated Google Maps address component types. Used when --reverse-geocode is GoogleMaps and --type is SelectedProperties.

string

API key for Google Maps. Also configurable via the PHOTO_CLI_GOOGLE_MAPS_API_KEY environment variable.

string

API key for LocationIq. Also configurable via the PHOTO_CLI_LOCATIONIQ_API_KEY environment variable.

boolean

Bypass the free-tier rate limit when using LocationIq with a paid license.

Example

Check the full raw response that OpenStreetMap returns for a photo’s GPS coordinates:

photo-cli address \
  --input /path/to/photo.jpg \
  --type FullResponse \
  --reverse-geocode OpenStreetMapFoundation

To see all available named properties without the raw JSON:

photo-cli address \
  --input /path/to/photo.jpg \
  --type AllAvailableProperties \
  --reverse-geocode OpenStreetMapFoundation

Run photo-cli address with --type FullResponse on a representative photo from each location before running photo-cli copy or photo-cli archive. The full response shows every property name (for OpenStreetMap), admin level (for BigDataCloud), or address component type (for Google Maps) that is available for that coordinate. Use those names directly in --openstreetmap-properties, --bigdatacloud-levels, or --googlemaps-types to build exactly the address format you want.

Get Started

Reverse Geocoding

Commands

Copy Examples

Configuration

Reference

Address Command Reference

Synopsis

Arguments

Required

Optional

Example

​Synopsis

​Arguments

​Required

​Optional

​Example

Synopsis

Arguments

Required

Optional

Example