Automatically processes GPX (GPS Exchange Format) files to extract waypoints, tracks, routes, and calculate geographic statistics like distance and elevation gain.
string
): The slug of the sheet the plugin should operate on.string
): The field slug in the source record that contains the GPX file content as a string.string
): The field slug that acts as a boolean flag. If the value in this field for a given record is the string “true”, duplicate points will be removed from the parsed data.string
): The field slug that acts as a boolean flag. If the value in this field for a given record is the string “true”, the parsed data will be filtered by a date range.string
): The field slug containing the start date for filtering. This is only used if filterDatesField
is set to “true”. The value should be a valid date string.string
): The field slug containing the end date for filtering. This is only used if filterDatesField
is set to “true”. The value should be a valid date string.removeDuplicatesField
, filterDatesField
) in the record are explicitly set to the string “true”. If filtering is enabled but the start or end date fields are empty or invalid, the date filter will not be applied.
listener
: FlatfileListener - The Flatfile listener instance to attach the hook toconfig
: GpxParserConfig - Configuration object containing field mappingspoint1
: Waypoint - Object with latitude
and longitude
propertiespoint2
: Waypoint - Object with latitude
and longitude
propertiespoints
: Waypoint[] - Array of waypoint objectspoints
: Waypoint[] - Array of waypoint objects with optional time
propertystartDate
: Date - Start of the date rangeendDate
: Date - End of the date rangetabularData
: Waypoint[] - Sorted array of waypoint objectstotalDistance
(km) and elevationGain
(meters) properties
waypoints
: Waypoint[] - Array of waypoint objectstracks
: Track[] - Array of track objectsroutes
: Route[] - Array of route objectssheetSlug
in the configuration exactly matches the slug of your target SheetgpxFileField
contains valid GPX XML contentfilterDatesField
contains the string “true” and that date fields contain valid date stringsgpxFileField
gpxFileField
commit:created
event using a recordHook