Places

Suntimes is configured using location data and maintains a private collection of places.

Manage Places

Places List

Suntimes -> Settings -> Places -> Manage Places to open the places list.

The places list can also be reached by tapping when selecting a place.

Add World Places

Suntimes includes coordinates for over 200 cities located around the globe.

Use : -> Add World Places to add world places to the list.

Search

Tap to search the list of places.

Add Place

To add a place, tap to show the add place dialog.

Tap to query the device’s current location, or manually input coordinates.

Finally, tap to save the place.

Permissions

Getting the current location requires location permissions. When prompted, grant permissions and enable device location to use this feature.

Copy, Edit, Remove

To copy a place, select it, then tap : -> Copy.

To remove a place, select it, then tap : -> Delete.

To edit a place, select it, then tap edit. Modify the label or coordinates, then tap to save changes.

To share a place, select it, then tap share.

Place coordinates can be displayed on a map, or by other applications that support location sharing.

Tip

The currently configured place can be shared from the main screen using the map button.

Import, Export

Use : -> Export to export the list of places to file.

Use : -> Import to import a previously exported list.

Tip

It is also possible to export or import places by creating or restoring a backup.

Clear Places

Use : -> Clear to clear the list of places.

Tip

Changes made to the place list will not affect existing configurations. It is safe to clear the list at any time. Places will be automatically added to the list when (re)configuring widgets or alarms.

Place Settings

Suntimes can query the device’s current location using the GPS or Network providers.

To configure this behavior, use Suntimes -> Settings -> Places to access the place settings.

Permissions

Getting the current location requires location permissions. When prompted, grant permissions and enable device location.

Location time limit

When requesting the current location, Suntimes will actively wait for a location update until the time limit expires.

The default location time limit is 1 minute.

Note

Location requests may time out if GPS or Network location providers are unavailable (and the current location is older than the max age).

Location recent max age

When requesting the current location, Suntimes will trigger a location update if the current location is older than the max age.

The default location max age is 5 minutes.

Passive Location

Suntimes can use the passive location provider to determine the device’s location. A separate app is required to make active update requests.