File Format

Poreia stores tracks in a custom .gpstrack format—zlib-compressed JSON for efficient storage.

Overview

Extension: .gpstrack
Compression: zlib
Uncompressed format: JSON
Typical compression ratio: 10-30% of original size

Schema Version

The current schema version is 4. Older tracks are automatically migrated when opened.

JSON Structure

{
  "schemaVersion": 4,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Morning Hike",
  "createdAt": "2026-02-02T10:30:00Z",
  "totalDistance": 1523.5,
  "duration": 3600.0,
  "elevationChange": 47.0,
  "startLocation": "Raleigh, NC",
  "notes": "Beautiful weather today.",
  "segments": [
    [
      {
        "latitude": 35.7796,
        "longitude": -78.6382,
        "altitude": 100.5,
        "timestamp": "2026-02-02T10:30:00Z",
        "horizontalAccuracy": 5.0,
        "speed": 1.2,
        "course": 45.0
      }
    ]
  ],
  "waypoints": [
    {
      "latitude": 35.7800,
      "longitude": -78.6380,
      "altitude": 102.0,
      "timestamp": "2026-02-02T10:45:00Z",
      "name": "Scenic Overlook",
      "description": "Feb 2, 2026 at 10:45:00 AM"
    }
  ]
}

Track Fields

Field	Type	Description
`schemaVersion`	Int	File format version (currently 4)
`id`	UUID	Unique track identifier
`name`	String	User-defined track name
`createdAt`	ISO 8601	When the track was created
`totalDistance`	Double	Total distance in meters
`duration`	Double	Elapsed time in seconds
`elevationChange`	Double?	Net elevation change in meters
`startLocation`	String?	Reverse-geocoded location name
`notes`	String?	User-defined notes (v4+)
`segments`	[[Point]]	Array of segments (new segment on pause)
`waypoints`	[Waypoint]	User-dropped pins

Track Point Fields

Field	Type	Description
`latitude`	Double	Latitude in degrees
`longitude`	Double	Longitude in degrees
`altitude`	Double	Altitude in meters
`timestamp`	ISO 8601	When the point was recorded
`horizontalAccuracy`	Double	GPS accuracy in meters
`speed`	Double	Speed in m/s
`course`	Double?	Direction in degrees 0-359 (v4+)

Waypoint Fields

Field	Type	Description
`latitude`	Double	Latitude in degrees
`longitude`	Double	Longitude in degrees
`altitude`	Double	Altitude in meters
`timestamp`	ISO 8601	When the waypoint was dropped
`name`	String?	User-defined name
`description`	String?	Auto-generated description

Schema History

Version	Changes
1	Initial format
2	Added `elevationChange`
3	Added `averageSpeed`, `maxSpeed`
4	Added `course` per point, `notes` on track

File Location

Saved tracks are stored in the app's private documents folder. They're not directly accessible via the Files app. To share a track, use the export feature.