Locations

iOS

Select the Locations tab to search for, save, and return to your favorite places.

Saved Locations

Once on the Location tab, you may either search for locations (by address/place or by coordinates) or manage your saved locations.

To manage your saved locations, tap "Saved locations." A list of your saved locations will display and you can use the search field to filter the locations by any matching or partially matching titles. Tapping the desired location will display the following icons:

	Move the primary pin to this location
	Move the secondary pin to this location (if geodetics is enabled)
	Edit location: you can rename it, manually change the coordinates, or add notes

Touch the "+" button to add a new location using the current primary pin position (or select between primary and secondary pins, if geodetics is enabled):

To delete a location, swipe left on the entry in the locations list and choose Delete.

Searching for Locations

Alternatively, navigate to either "Search for address/place" or "Search for coordinates" to search the web for corresponding place names using a geocoding service.

Tap to select a search result. The selected location will show two or three icons:

	Move the primary pin to this location
	Move the secondary pin to this location, and enable geodetics if necessary
	Save location to your list

TPE saves the timezone and elevation above sea level for locations (as long as the device has Internet connectivity) so you can obtain accurate rise/set information for saved locations without needing network connectivity at a later time.

Tips for Searching

You may not find exactly what you're looking for first time around. e.g. both the UK and the US have places named 'Keswick'. If the web search returns the wrong one, try adding a little more to your search to make it unambiguous which location you're looking for, e.g. 'Keswick, UK'.

The app uses your device's approximate location and/or region setting to try to scope search results appropriately, but this may inadvertently include or exclude certain results, so be patient and experiment a little!

Favorite Locations

You can mark a location as a favorite by tapping the star button in the saved locations list (tap again to remove the location from your favorites).

Location is a favorite

By default, favorite locations are always shown the map (you can override this in Settings). Additionally, after tapping in the search bar, you can filter your locations list to display only favorites.

Location Synchronization

Location synchronization is available free of charge within the app. On first tapping the button, you will be prompted to sign up or sign in, if necessary.

Synchronize locations

Once you are signed up for Location Synchronization, your saved locations can be shared across multiple devices running TPE on iOS, and also with the Photo Ephemeris Web (app.photoephemeris.com). This allows for planning at home on a desktop computer, after which you can sync your locations to your mobile devices for use in the field.

As with Photo Ephemeris Web, the latest edits to a location are retained in the case of a synchronization conflict (i.e. the same location was edited on two different devices). Note: the time of the edit is what is tested, not the time when you synchronize.

Once a location has been synced, and if you are signed into your account, a cloud icon is displayed to the right of the location in the list:

	If the location has not yet been synchronized, no icon will be displayed
	The location has been synchronized from the device to the server
	There are changes to the local copy that need to be synchronized to the server
	The location belongs to a different user account: it can only be synchronized when signed in to the owning account. You will only see this if you use multiple different Crookneck Photo Apps with Location Sync on the same device.

Note: you will need to press synchronize to pull changes from the server down to the device, as well as to push changes from the device up to the server.

Exporting Locations

You can export your locations from TPE as a KML file. KML (Keyhole Markup Language) is a text-based file format widely used to share geographic information between applications.

To export your locations, tap the action button at the top of the Locations list. Choose "Export Locations." Once exported, you can email the KML file to an address of your choosing.

Importing Locations

You can import locations from a KML or KMZ (zipped KML) document by sending the file as an email attachment. Open the email on your iOS device, and then open the attachment in TPE (you may need to choose Open In…, then TPE). TPE will prompt you to ask if you want to import locations from the file. If you choose Import, any locations found in the document will be added to your locations list.