TPE URL Parameters – Help Center

All versions of Photo Ephemeris use a standard form of URL. You can construct your own URLs (e.g. via a scripting tool or by manually editing the address in your browser) and use them freely - they'll open in the web app, iOS or Android apps as normal.

Simple Example

Here's an example:

https://app.photoephemeris.com/?ll=63.939897,-17.369803&center=63.9586,-17.3145&z=9&spn=0.64,3.09&dt=20170125170400%2B0000&sll=63.972628,-17.052924

In this example, the parameters are used as follows:

Parameter	Value	Usage
ll	63.939897,-17.369803	Red map pin location. Latitude, longitude coordinate pair in decimal degrees. Negative longitude is west.
center	63.9586,-17.3145	Center of map. Latitude, longitude coordinate pair in decimal degrees. Negative longitude is west.
z	9	Zoom level. Value between 0 and 21 (max value may be lower with certain map types selected)
spn	0.64,3.09	Span. Decimal degree pair showing latitude and longitude span. Equivalent to Zoom level. Use either.
dt	20170125170400%2B0000	Date/time. Date and time in format YYYYMMDDHHnnss+ZZZZ. '%2B' is the URL-encoded form of '+'
sll	63.972628,-17.052924	Secondary pin location (optional). Latitude, longitude coordinate pair in decimal degrees. Negative longitude is west.

Advanced Example (iOS)

A more advanced example from TPE for iOS that shows some additional parameters:

https://app.photoephemeris.com/?ll=40.019526,-105.264055&center=40.0195,-105.2635&spn=0.00,0.00&z=17.3&dt=20170125102221-0700&sll=40.019491,-105.262286&sh=5.00&ch=30.00&seo=-2.00&ceo=4.00

Here's a list of the parameters not mentioned above:

Parameter	Value	Usage
sh	5.00	Primary object height in meters. e.g. the height of the camera above the ground
ch	30.00	Secondary object height in meters. e.g. the height of a building
seo	-2.00	Primary elevation offset in meters. Correction to the automatically determined elevation above sea level for the primary map pin location.
ceo	4.00	Secondary elevation offset in meters. Correction to the automatically determined elevation above sea level for the secondary map pin location.

Note: in settings in the iOS app, you can reverse the sense of primary and secondary depending on whether you are using the primary pin as the camera or subject location. The mappings shown in the table above from primary or secondary are reversed accordingly.

Related articles