Integration

Integration with external sites:

The GPS Team Challenge welcomes integration with external sites. The system described below allows any site to prefill data on the post session page. For example, if another site calculates speeds, then the idea is that the user can click a button on that site, and they will be taken to the "post session" page on the GPS Team Challenge website, with the relevant fields prefilled.

To get your data onto our site, the following method is required:

A POST form needs to be created on the external site, with the "action" field set to: "http://gpsteamchallenge.com.au/sailor_session/post". For testing, the following URL may be used: "http://dev.gpsteamchallenge.com.au/sailor_session/post".
The following POST fields should be set:

POST field name Field Text Field Data Type Units Sample data Comment
load_from_post {hidden} boolean - true Set to "true" to load data from your POST fields
date Date string - 2009-04-12 Date of Session (YYYY-MM-DD). Note that dates more than a month old may be discarded, see the rules page for more info.
2_sec_peak 2 Sec Peak decimal knots 29.896 2 Second Peak Speed
2_sec_peak_calc_method 2 Sec Peak Calculation Method enum - D Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
5x10 5 x 10 Sec decimal knots 27.341 5 x 10 second average speed
5x10_calc_method 5 x 10 Sec Calculation Method enum - D Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
1_hour 1 hour decimal knots 16.434 Average speed over 1 hour
1_hour_calc_method 1 hour Calculation Method enum - D Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
alpha_500 Alpha 500 decimal knots 19.906 Alpha 500 speed
alpha_500_calc_method Alpha 500 Calculation Method enum - T Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
nautical_mile Nautical Mile decimal knots 24.949 Nautical Mile Speed
nautical_mile_calc_method Nautical Mile Calculation Method enum - D Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
distance Distance decimal km 98.052 Total Distance
distance_calc_method Distance Calculation Method enum - D Possible values are X for unknown, D for Doppler, T for Trackpoints, L for GpsLogit app.
sailor_session_comments Comments string - Early session down at Mandurah. Loft Blade 6.8, iSonic 94/Weedburner 29, also tried Lemony Snicketts/JP31 weedy. Great to catch up with Elmo and Evets, had a lot of fun being overtaken again and again by Evets. I blame the fin (it was light so I tried the JP31) of course it's got nothing to do with how much Evets has improved lately! Well done mate. So good to get on the water again, even if it was a gusty easterly. Comments about the session

A sample form with these details is below.



XML Data

If you wish to retrieve details of a specific session from the GPS Team Challenge website, then you can do so in the following way:
Request a page from the following address:
http://gpsteamchallenge.com.au/sailor_session/get_session_xml?date={DATE}&sailor_id={SAILOR_ID}
where {DATE} is a string of the form YYYY-MM-DD, and {SAILOR_ID} is the ID of the sailor you wish to retrieve data for.

An example XML feed is on the other side of this link:
http://gpsteamchallenge.com.au/sailor_session/get_session_xml?date=2009-04-12&sailor_id=1





More information

If you would like more information on integrating your site with the GPS Team Challenge, please don't hesitate to contact us.