Select the Locations tab to search for, save and return to your favourite places.
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).
Alternatively, type a place name in the search field. This will do two things: (i) filter your list of saved locations for any matching or partially matching titles; (ii) search the web for corresponding place names using a geocoding service. Note that you will need to cancel the search to access the "+" and synchronize buttons, as these controls are hidden by iOS while the search is active.
Tap to select a search result. Two or three buttons are displayed:
|Move the primary pin to this location|
|Move the secondary pin to this location, and enable geodetics if necessary|
|Save location to your list|
|Edit location: you can rename it, manually change the coordinates, or add notes|
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.
To delete a location, swipe left on the entry in the locations list and choose Delete.
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!
You can mark a location as a favorite by tapping the star button in the location list (tap again to unfavorite the location).
|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 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.
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 TPE web app (app.photoephemeris.com). This allows for planning at home on a desktop computer, after which you can synch your locations to your mobile devices for use in the field.
As with the TPE web app, 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 synched, and if you are signed into your account, a cloud icon is displayed to the right of the location in the list:
|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 Synch 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.
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.
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.
Note: Not all KML files will contain locations that TPE can import. Specifically, TPE looks for Placemark entries in the KML document that include latitude/longitude coordinates.
Warning: TPE does not attempt to detect duplicate locations in any KML file that is imported. If you import the same file twice, you will see duplicate locations in your list.
You can remove duplicate locations by choosing Delete duplicate locations in the Settings screen.