diff --git a/website/src/lib/docs/en/files-and-stats.mdx b/website/src/lib/docs/en/files-and-stats.mdx index 3d8bf743..b25755f7 100644 --- a/website/src/lib/docs/en/files-and-stats.mdx +++ b/website/src/lib/docs/en/files-and-stats.mdx @@ -51,7 +51,8 @@ Click on the profile to reset the selection. ### Additional data Using the buttons on the right of the elevation profile, you can optionally color the elevation profile by: -- **Slope** information computed from the elevation data -- **Surface** data coming from OpenStreetMap's surface tags. This is only available for files created with **gpx.studio**. +- **slope** information computed from the elevation data, or +- **surface** data coming from OpenStreetMap's surface tags. +This is only available for files created with **gpx.studio**. -If your selection includes it, you can also visualize: **Speed** , **Heart rate** , **Cadence** , **Temperature** and **Power** data on the elevation profile. +If your selection includes it, you can also visualize: **speed** , **heart rate** , **cadence** , **temperature** and **power** data on the elevation profile. diff --git a/website/src/lib/docs/en/gpx.mdx b/website/src/lib/docs/en/gpx.mdx index 1e8bc1f3..9c2067fa 100644 --- a/website/src/lib/docs/en/gpx.mdx +++ b/website/src/lib/docs/en/gpx.mdx @@ -1,5 +1,34 @@ --- -title: The GPX file format +title: GPX file format --- -# { title } \ No newline at end of file + + +# { title } + +The GPX file format is an open standard for exchanging GPS data between applications and GPS devices. +It essentially consists of a series of GPS points encoding one or multiple GPS traces, and optionally some points of interest. + +GPX files may also contain metadata, of which the **name** and **description** fields are the most useful for users. + +### Tracks, segments and GPS points + +As mentioned above, a GPX file can contain multiple GPS traces. +These are organized in a hierarchical structure, with tracks at the top level. + +- A **track** is made of a sequence of disconnected segments. +Furthermore, it can contain metadata such as a **name**, a **description**, and **appearance properties**. +- A **segment** is a sequence of GPS points that form a continuous path. +- A **GPS point** is a location with a latitude, a longitude, and optionally a timestamp and an altitude. +Some devices also store additional information such as the heart rate, the cadence, the temperature and the power. + +In most cases, GPX files contain a single track with a single segment. +However, the hierarchy described above allows for more advanced use cases, such as planning multi-day trips with several variants for each day. + +### Points of interest + +**Points of interest** (technically called *waypoints*) represent locations of interest to show either on a GPS device or on a digital map. + +In addition to its coordinates, a point of interest can have a **name** and a **description**.