{"id":778,"date":"2019-02-06T13:12:03","date_gmt":"2019-02-06T13:12:03","guid":{"rendered":"https:\/\/rallycheck.com\/?page_id=778"},"modified":"2020-03-18T16:50:12","modified_gmt":"2020-03-18T15:50:12","slug":"gps-to-gpx-definitions","status":"publish","type":"page","link":"https:\/\/rallycheck.com\/nl\/gps-to-gpx-definitions\/","title":{"rendered":"GPS to GPX definitions"},"content":{"rendered":"

GPS to GPX definitions<\/h3>

As per 18 March 2020<\/p>\n<\/div>

<\/div><\/div><\/div>
\n

Rallycheck uses GPX files for defining waypoints (route controls or RC’s) in the app.<\/p>\n

Rallycheck also uses self-defined extensions in order to define all types of “rally” options for RC’s. This page shows the current definitions of the RC’s and it’s extensions. This definition can be used bij software programs connecting to the Rallycheck app.<\/p>\n

Please only use extensions for non default values. When using the default, please omit the extensions from your XML.<\/p>\n

The following code shows an example of the definition.<\/p>\n<\/div><\/section><\/p><\/div>\n

<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<gpx version=\"1.1\" creator=\"Rallycheck\" xmlns=\"http:\/\/www.topografix.com\/GPX\/1\/1\" xmlns:gpxx = \"http:\/\/www.garmin.com\/xmlschemas\/GpxExtensions\/v3\">\r\n<wpt lat=\"4.47518234141171\" lon=\"52.192538939416409\">\r\n    <name>X<\/name>\r\n    <extensions>\r\n        <gpxx:WaypointExtension>\r\n        <gpxx:Proximity>45<\/gpxx:Proximity>\r\n        <gpxx:Directsave>False<\/gpxx:Directsave>\r\n        <gpxx:BearingEnabled>False<\/gpxx:BearingEnabled>\r\n        <gpxx:Bearing>0<\/gpxx:Bearing>\r\n        <gpxx:BearingDeviation>22.5<\/gpxx:BearingDeviation>\r\n        <gpxx:Instruction>HK EL<\/gpxx:Instruction>\r\n        <gpxx:Showspeed>False<\/gpxx:Showspeed>\r\n        <gpxx:Showtime>False<\/gpxx:Showtime>\r\n        <gpxx:RCType>RC<\/gpxx:RCType>\r\n        <gpxx:TimeToSave>60<\/gpxx:TimeToSave>\r\n        <\/gpxx:WaypointExtension>\r\n    <\/extensions>\r\n<\/wpt>\r\n<\/gpx><\/pre>\n
Proximity<\/strong><\/p>\n
Optional field.
\nDefault value: 45 meters.
\nAllowed values: integer or 2 decimal floating point
\nImplemented in app.<\/p>\n
The proximity to the RC in meters. The app will detect the RC when the app is within the proximity in meters to the RC.<\/p>\n
\n
Directsave<\/strong><\/p>\n
Optional field.
\nDefault value: False
\nAllowed values: True, False
\nImplemented in app.<\/p>\n
This extension wil save the RC without the option for the user te discard it. Normally a user can chose to save the RC. When the value of Directsave is true, the user has no choice and the RC will be saved.<\/p>\n
\n
BearingEnabled<\/strong><\/p>\n
Optional field.
\nDefault value: flase
\nAllowed values: true, false
\nImplemented in app.<\/p>\n
This extension defines if the Bearing is used for a specific Waypoint.<\/p>\n
\n
Bearing<\/strong><\/p>\n
Optional field.
\nDefault value:\u00a0(empty)
\nAllowed values: integer, 0 – 360
\nImplemented in app.<\/p>\n
This extension defines the bearing the smartphone is traveling in. If the smartphone is traveling in this direction than the waypoint will be “discovered”. If the smartphone is traveling in a different direction, the waypoint will not be shown to the user.<\/p>\n
The value of Bearing is in compass degrees. North = 0; South = 180 etc.<\/p>\n
The default behavior of the Rallycheck app is to allways show a RC, independent of the bearing.<\/p>\n
\n
BearingDeviation<\/strong><\/p>\n
Optional field.
\nDefault value: 22.5
\nAllowed values: Integer or Floating point, one decimal, 0-180
\nImplemented in app.<\/p>\n
This extension defines the deviation to the Bearing that is accepted by the Rallycheck app when determining the Bearing in which the smartphone is traveling. This extension is only used in conjunction with the Bearing extension. If the Bearing extension is not used (or is empty) the BearingDeviation will be ignored.<\/p>\n
For example, a smartphone, traveling exactly from east to west has a Bearing of 270 (degrees). However, it is unlikely that the GPS bearing will exactly match the value in the Bearing field, each and every time for each and every moving smartphone.
\nWith a BearingDeviation of 22.5 (degrees) all dirctions from 247.5 degrees to 292.5 degrees are accepted as valid by the Rallycheck app.<\/p>\n
\n
Instruction<\/strong><\/p>\n
Optional field.
\nDefault value: (empty)
\nAllowed value: text
\nImplemented in app.<\/p>\n
This extension enables an instruction to be shown to the user of the Rallycheck app. Too long text messages will be truncated.<\/p>\n
For example: HK EL DMP3
\n“Hier Keren, Einde Links, Door met Punt\/Pijl 3”
\n“Turn here, end left, continue with point\/arrow 3”<\/p>\n
\n
Showspeed<\/strong><\/p>\n
Optional field.
\nDefault value: False
\nImplemented in app.<\/p>\n
Using this extension will display the speed of the smartphone at the moment the RC is detected. The speed will be shown beneath the RC name on the control card.<\/p>\n
\n
Showtime<\/strong><\/p>\n
Optional field.
\nDefault value: False
\nImplemented in app.<\/p>\n
Using this extension will display the GPS time at the moment the RC is detected. The time will be shown beneath the RC name on the control card.<\/p>\n
\n
RCType<\/strong><\/p>\n
Optional field.
\nDefault value: RC
\nAllowed Value: text
\nPartialy implemented, see following definitions.<\/p>\n
This extension qualifies the Control type. The following controls are possible.<\/p>\n
    \n
  • RC (Default)<\/li>\n
  • START – implemented<\/li>\n
  • FINISH – implemented<\/li>\n
  • TC- implemented<\/li>\n
  • TC-IN- implemented<\/li>\n
  • TC-OUT<\/li>\n
  • TC-START<\/li>\n
  • TC-FINISH- implemented<\/li>\n
  • GTC<\/li>\n<\/ul>\n
    \n
    TimeToSave<\/strong><\/p>\n
    Optional field.
    \nDefault value: 60
    \nAllowed value: integer
    \nImplemented in app.<\/p>\n
    Time in seconds. This field describes the time in which a contestant can click the save button of a route control.
    \nWe strongly urge you NOT to use this option. It is confusing for contestants to encounter route controls with variable save times.
    \nThis option is available for development purposes.<\/p>\n
    \n<\/div><\/section>
    \n
      <\/ul><\/div><\/p><\/div>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-778","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/pages\/778","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/comments?post=778"}],"version-history":[{"count":35,"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/pages\/778\/revisions"}],"predecessor-version":[{"id":2836,"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/pages\/778\/revisions\/2836"}],"wp:attachment":[{"href":"https:\/\/rallycheck.com\/nl\/wp-json\/wp\/v2\/media?parent=778"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}