geotrace-sdk

Python bindings for the GeoTrace SDK: read and write .gtd GNSS/GPS navigation data files.

.gtd is the open binary recording format used by GeoTrace, a desktop application for visualizing GPS/GNSS navigation data: position traces on a map, satellite signal quality, event markers, and filtering.

MIT licensed. Requires Python 3.12+.

Install

uv add geotrace-sdk

pip install geotrace-sdk

Distributed as abi3 wheels (one cp312-abi3 wheel per platform, forward-compatible with newer CPython) for Linux (manylinux and musllinux), macOS, and Windows. A platform without a matching wheel builds from the source distribution, which requires a Rust toolchain.

Write a track

from datetime import datetime, timezone
from geotrace_sdk import NavFileBuilder, NavFix

builder = NavFileBuilder()
builder.add(NavFix(
    lat=51.5074,
    lon=-0.1278,
    gps_time=datetime(2024, 1, 15, 9, 0, 0, tzinfo=timezone.utc),
    heading=90.0,
))
builder.finish().write_to_file("track.gtd")

add() also accepts satellite reports, map annotations, and event markers.

Read a file

from geotrace_sdk import NavFile

nav_file = NavFile.open("track.gtd")
print(len(nav_file.points), "points,", len(nav_file.markers), "markers")
for point in nav_file.points:
    print(point.lat, point.lon, point.gps_time)

Examples

Runnable examples are in sdk/python/geotrace-py/examples:

write_basic: minimal write workflow.
read_file: read a .gtd file and print a content summary.
with_satellites: pair each fix with a satellite visibility report.
event_markers: write and read hierarchical event markers.
from_csv: convert CSV rows into a .gtd file.
from_multiple_sources: merge fixes and events from separate sources.
gold_dataset: build the cross-SDK reference file and verify the round-trip.

Full list and per-platform notes: docs/sdk/python.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geotrace_sdk-0.4.0.tar.gz (125.7 kB view details)

Uploaded Jul 8, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

geotrace_sdk-0.4.0-cp312-abi3-win_arm64.whl (584.3 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+Windows ARM64

geotrace_sdk-0.4.0-cp312-abi3-win_amd64.whl (612.2 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+Windows x86-64

geotrace_sdk-0.4.0-cp312-abi3-win32.whl (588.3 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+Windows x86

geotrace_sdk-0.4.0-cp312-abi3-musllinux_1_2_x86_64.whl (887.1 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+musllinux: musl 1.2+ x86-64

geotrace_sdk-0.4.0-cp312-abi3-musllinux_1_2_i686.whl (921.0 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+musllinux: musl 1.2+ i686

geotrace_sdk-0.4.0-cp312-abi3-musllinux_1_2_armv7l.whl (937.8 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+musllinux: musl 1.2+ ARMv7l

geotrace_sdk-0.4.0-cp312-abi3-musllinux_1_2_aarch64.whl (818.0 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+musllinux: musl 1.2+ ARM64

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (670.1 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.17+ x86-64

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl (715.0 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.17+ s390x

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (745.7 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.17+ ppc64le

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (661.2 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.17+ ARMv7l

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (640.1 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.17+ ARM64

geotrace_sdk-0.4.0-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl (723.5 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+manylinux: glibc 2.5+ i686

geotrace_sdk-0.4.0-cp312-abi3-macosx_11_0_arm64.whl (615.6 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+macOS 11.0+ ARM64

geotrace_sdk-0.4.0-cp312-abi3-macosx_10_12_x86_64.whl (651.3 kB view details)

Uploaded Jul 8, 2026 CPython 3.12+macOS 10.12+ x86-64

File details

Details for the file geotrace_sdk-0.4.0.tar.gz.

File metadata

Download URL: geotrace_sdk-0.4.0.tar.gz
Upload date: Jul 8, 2026
Size: 125.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for geotrace_sdk-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`a97533926aaabac9cca96ee223d993ead640a720a8c96f8acc4051cd00570a5e`
MD5	`77cb1f6847cae4949e984017fb3535b8`
BLAKE2b-256	`b50ab0dd3fce7d98aa825913eaeb1b5c9a11dc51e6f9a77b4aad3be94cf7f96b`

Algorithm	Hash digest
SHA256	`25416b5e1e48467f424ee327d5c272c1362b36651063b8572d49d42f2f34acaa`
MD5	`419c554831b0fc55abc00112dfe69cf4`
BLAKE2b-256	`0d8c6c64dab04f765f479397e3132228020c68bca35e468da134d07f6b8f639e`

Algorithm	Hash digest
SHA256	`9c281f479c3a15f1076adb1946491761f88f11e6333e52cdbdd83c47f3c41d4f`
MD5	`4a0a23b31f0556bd1e8616da4b815340`
BLAKE2b-256	`a4b05ee9de242a636d983871ae3f86975fd1a648aff92df2eac84a7afe7a4006`

Algorithm	Hash digest
SHA256	`efd3b80aa49e60c684dd6a2ebe96d44b5be1938db3d622654faab7a1727dfee3`
MD5	`e78c3b887411cc837d330db8f7799beb`
BLAKE2b-256	`3835e01ede7b3f6089365493808211e8522c9b95e1faae05d295e0d46d7872a5`

Algorithm	Hash digest
SHA256	`bfd2497a294ad8505d5e2d981694cba3aca1124c3ca565741495813c3f12ce38`
MD5	`19fe88bbd7b292b56918649637e7b0e2`
BLAKE2b-256	`16e185d553d8ddb23dad30c0fad96ce27efbef5099cc38ab9c263877fbff5da7`

Algorithm	Hash digest
SHA256	`8e7c6f2f73b702a677e2428dab5b7164602ebd02fa3323eb6973275bedc4a60e`
MD5	`679d5495def9e87f0b0205d8288aa2c1`
BLAKE2b-256	`c9885a54915090a81118c7a4ee87085f98093078b19dcdb0bf30e2944b3a6b51`

Algorithm	Hash digest
SHA256	`5f980f974594e19f9c972744c04cb8d34d744bee57657f53d03fc0a9d331370d`
MD5	`a0ee5a07e850a64349d1c546983e137f`
BLAKE2b-256	`6cbe4d390bba44fc1eabe249f34b0eae8d2df45a5851fba2ad7e953eefdeba66`

Algorithm	Hash digest
SHA256	`cf4e0badb55554b03b689461e7793d953592ba3c1f5c35762c39c85be7e5f73d`
MD5	`2320d3e8f8dc69c1fb78ab6b7b5575f7`
BLAKE2b-256	`4b9bdf97673baef94f826506956599334e48cc39fe3d8ba03a0b6446e01aaadf`

Algorithm	Hash digest
SHA256	`0199146a697d39c18655ab7d06a9d6ffa838d63f0fd380ae56d77431bab89094`
MD5	`e843166c9f1cf392ac9a0d44edd5f6d7`
BLAKE2b-256	`ca03226790cac17adb124952ab9674094b6af40b417fd8e60fa79eb092204a65`

Algorithm	Hash digest
SHA256	`8043c360be7a29d5db5e64c5b89a4c95c53ca3b63d35106388f09988b8c5e073`
MD5	`c484a5d78deab80ec8dd806c9351595d`
BLAKE2b-256	`fc41b4f46f6786321130bc40d722e1cc52ca38adc8c61fbd36c962addf482034`

Algorithm	Hash digest
SHA256	`e1074aaf24645cc41cd28f476bc4e93f587883dc74ccb507d4327a5ef25385a5`
MD5	`e8562d77816b412482220a015942386b`
BLAKE2b-256	`e107f07c80e7e636dbcd950268df16ef9561581f9a5a758e96cd0963b562a377`

Algorithm	Hash digest
SHA256	`705e0510e4f813058c66a5538c41e0e2ec0fc4e6fea03fbd1d5a49a59864039b`
MD5	`579d5802529850ee1061fb65c728758d`
BLAKE2b-256	`46fcd9a32c938a7e673dc2191e91ef29f04b387302a8c05aec23dce1e0e8f008`

Algorithm	Hash digest
SHA256	`72da6144d3220ff1c0a5d45fd0870688e014e85303edb14c5e21dd3d67eec1fb`
MD5	`6adee2ebd09e9f271b9d5361b63ed144`
BLAKE2b-256	`808ad05c4f8817d12b00ed1bb987dfed360d6b415141dca1197cc2d968f89b94`

Algorithm	Hash digest
SHA256	`ae0505e86a85593f412f60c9dc54fbe9e1d40d9e51fa73f41594c31510ad6bea`
MD5	`667f66d20b45278abfac8de044b6d490`
BLAKE2b-256	`57b80e940f5ab4f1e9320c080abaddb545b7b81d1cac49a2776f7d108c71edeb`

Algorithm	Hash digest
SHA256	`0e77bcbda88fb1cc1b30ea49f6b120e6d430c60ab5cfab5feb7232a50598df92`
MD5	`285032cc0669e57b1710c04ba31d3360`
BLAKE2b-256	`ca6e4f9a37549053bfe8d402a7d19958b6b46ea31ec2b04cf99ee20d54a0c372`

Algorithm	Hash digest
SHA256	`2d4222411c784d64cae8a95b5ef8f20cb60b1a3e19e185c4dc54b32202677972`
MD5	`f981551f6d352b583d7051010d6a7cbd`
BLAKE2b-256	`78d4772020bfd98847a03ec0e9e626b604f599b84cb973432bb6a35dda3874e3`

geotrace-sdk 0.4.0

geotrace-sdk

Install

Write a track

Read a file

Examples

Links

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details