Follow

TPE URL Parameters

All versions of TPE 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:

http://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:

http://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 new parameters not mentioned above:

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

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk