Skip to main content

Documentation Index

Fetch the complete documentation index at: https://photocli.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
--input, -i
string
required
Path to the photo file whose GPS coordinates you want to resolve. Only a single file is accepted.
​
--type, -t
enum
required
Controls how much detail is returned from the provider.
NameValueDescription
AllAvailableProperties0Returns every address property available for the photo’s coordinates
SelectedProperties1Returns only the properties you specify via the provider-specific argument
FullResponse2Returns the complete raw JSON response from the provider

​
Optional

​
--reverse-geocode, -e
enum
Third-party provider used to resolve GPS coordinates. See reverse geocoding overview for setup details.
NameValue
Disabled (default)0
BigDataCloud1
OpenStreetMapFoundation2
GoogleMaps3
LocationIq5
​
--openstreetmap-properties, -r
string
Space-separated OpenStreetMap address property names to include in the output. Used when --reverse-geocode is OpenStreetMapFoundation or LocationIq and --type is SelectedProperties.
​
--bigdatacloud-levels, -u
string
Space-separated BigDataCloud admin level numbers. Used when --reverse-geocode is BigDataCloud and --type is SelectedProperties.
​
--bigdatacloud-key, -b
string
API key for BigDataCloud. Also configurable via the PHOTO_CLI_BIG_DATA_CLOUD_API_KEY environment variable.
​
--googlemaps-types, -m
string
Space-separated Google Maps address component types. Used when --reverse-geocode is GoogleMaps and --type is SelectedProperties.
​
--googlemaps-key, -k
string
API key for Google Maps. Also configurable via the PHOTO_CLI_GOOGLE_MAPS_API_KEY environment variable.
​
--locationiq-key, -q
string
API key for LocationIq. Also configurable via the PHOTO_CLI_LOCATIONIQ_API_KEY environment variable.
​
--has-paid-license, -h
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.