Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

1.6 KB
Raw Blame

search: false

::: warning Archived documentation These instructions describe older deployments and environment-based settings. For current installations, use Getting Started and manage settings in the dashboard. :::

Location Providers

Location providers convert photo GPS coordinates (latitude and longitude) into human-readable city or country names during photo processing. This process is called Reverse Geocoding.

By default, no configuration is required. ChronoFrame uses OpenStreetMap Nominatim as the default location provider.

However, you may need to configure a custom location provider in the following cases:

  • Your server is located in mainland China
  • The connection between your server and Nominatim is blocked

ChronoFrame supports two location providers. You can choose the appropriate one based on your needs.

Nominatim

Nominatim is a free reverse geocoding service provided by OpenStreetMap. By default, ChronoFrame uses Nominatim as the location provider.

If your server cannot connect to the official Nominatim service, you can set up your own reverse proxy and use it through the following configuration:

NUXT_NOMINATIM_BASE_URL=http://your-nominatim-proxy-url/

Mapbox Search API

Mapbox Search API provides powerful reverse geocoding capabilities. To use Mapbox as your location provider, you need a Mapbox access token.

NUXT_MAPBOX_ACCESS_TOKEN=your-mapbox-access-token

When you configure the NUXT_MAPBOX_ACCESS_TOKEN environment variable, ChronoFrame will automatically use Mapbox Search API as the location provider.