Skip to main content

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

Or

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:

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

Links

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.5.1.tar.gz (141.1 kB view details)

Uploaded Source

Built Distributions

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

geotrace_sdk-0.5.1-cp312-abi3-win_arm64.whl (702.8 kB view details)

Uploaded CPython 3.12+Windows ARM64

geotrace_sdk-0.5.1-cp312-abi3-win_amd64.whl (742.0 kB view details)

Uploaded CPython 3.12+Windows x86-64

geotrace_sdk-0.5.1-cp312-abi3-win32.whl (721.5 kB view details)

Uploaded CPython 3.12+Windows x86

geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_x86_64.whl (1.0 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ x86-64

geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_i686.whl (1.1 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ i686

geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_armv7l.whl (1.1 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARMv7l

geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_aarch64.whl (926.2 kB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARM64

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (791.9 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ x86-64

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl (855.0 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ s390x

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (875.1 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ppc64le

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (794.7 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ARMv7l

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (748.3 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ARM64

geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl (872.3 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.5+ i686

geotrace_sdk-0.5.1-cp312-abi3-macosx_11_0_arm64.whl (722.4 kB view details)

Uploaded CPython 3.12+macOS 11.0+ ARM64

geotrace_sdk-0.5.1-cp312-abi3-macosx_10_12_x86_64.whl (768.1 kB view details)

Uploaded CPython 3.12+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: geotrace_sdk-0.5.1.tar.gz
  • Upload date:
  • Size: 141.1 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.5.1.tar.gz
Algorithm Hash digest
SHA256 5d836e1b014d968eb670b7d13933cedee2c1820850b66f6c6e19cc932113766b
MD5 d62fd6d4e97e8795e00e6ba052aebcc6
BLAKE2b-256 771584ba45e3607d2af73597b8042ab2c1a522d9dc85af879bfbd9d2a1b5eada

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1.tar.gz:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-win_arm64.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.1-cp312-abi3-win_arm64.whl
  • Upload date:
  • Size: 702.8 kB
  • Tags: CPython 3.12+, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-win_arm64.whl
Algorithm Hash digest
SHA256 2f02347578c1fe7dc95041f7febe9e851de7886552fd7bf4e306ff7ffe9b1a9b
MD5 0497b6ee16682c718183dd499a3f30f1
BLAKE2b-256 9f2f84096911aaaf862ddc4bb3f06616358ad94157fe5a6790b97f72a083e137

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-win_arm64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-win_amd64.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.1-cp312-abi3-win_amd64.whl
  • Upload date:
  • Size: 742.0 kB
  • Tags: CPython 3.12+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 f26c6e179d62f6d49ec4b7a3d7b85c735440861fd647e350844429b7b801b31f
MD5 220651eef57bb3f09326b4cdeeb7372c
BLAKE2b-256 0f06593b7caa8e17c39ef959956054115b333df8bd2b16943ace476a6726bb0f

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-win_amd64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-win32.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.1-cp312-abi3-win32.whl
  • Upload date:
  • Size: 721.5 kB
  • Tags: CPython 3.12+, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-win32.whl
Algorithm Hash digest
SHA256 21aa73f528a20caeb0efa7adce0d929ed6327d5eae2a4b56db5cfbb138854b20
MD5 a69c3478fb565622cf1e1e9c52ff870c
BLAKE2b-256 6c26901a9cc8dac65aa5bccadd73d776f6d0d37fae6dcb050c18babbbc820451

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-win32.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 856af1a3a9a204d3f9d1c7c2c7a084419290e38f2352e15b90d3110490d5900f
MD5 eb3dd57f2f79af4ba53c14734875f903
BLAKE2b-256 d2c4bfde3039d62fba1139f16a65a0c9e3bae3ef93047504e87c22c7f50047eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_x86_64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_i686.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_i686.whl
Algorithm Hash digest
SHA256 1e91dd58dca69bd6656e9196d4dd9ef5785a0835ac6f65a9e1656d5396b345d3
MD5 1c74e7af92dfdeac3dcd5c870f718e8a
BLAKE2b-256 7d60056d576eb0d0c237faf101c28012904513886b33dce06c8a2c13f7ef1582

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_i686.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_armv7l.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_armv7l.whl
Algorithm Hash digest
SHA256 c23e39ee60a15e248dc44ce719bc314299a2b9db373e1386b469b5edaa3ed3d6
MD5 aec8ac6c6fe8d36a855d5e57cfa68f7a
BLAKE2b-256 476aac4ae6557eb592145a6aacea67d305c75d73d0d53018bf87b06a859ce8ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_armv7l.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 1448d198afc910483c62305398d0d3a95bbbc982cb65d85cc319edd7fc960b9e
MD5 87556b62518392ae0b7460c086b4d5df
BLAKE2b-256 7bca19e1b39d72109c2eb3b79db55f5164bbec6e705f04405b15c00a95944ce3

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-musllinux_1_2_aarch64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9139d2948566e2b8913409ebfd14bad4556f2876f0df019e13f171c935be058c
MD5 03e4859695894fe7a67577fd6d87180b
BLAKE2b-256 2b4a8ed7f108ebc2e8d898a0283ed8f39dafbc638be4593cafd7f23ebfbd3132

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl
Algorithm Hash digest
SHA256 a5f2d61a59ca66d74ce52b162b62ec311ebbb2b654d462d51e42e1d796d32ea2
MD5 faf37dde35784751d87461f8224a08c9
BLAKE2b-256 6898b94d665f792f288fa17726c9706748fcf84e808c9033560b13b36c308dd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Algorithm Hash digest
SHA256 3f387a73fbc04111b0513955d12103d1829512a9f11c2c6704ee6dbd55fbf24c
MD5 766a40eb1d51ae77395868b6d3da5e0c
BLAKE2b-256 c42cb1b0e9be8de3cc1d7e6a23a12620c40f92b55112620c02a3b05344516cc3

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm Hash digest
SHA256 a0341cc3150ca3f2fbc26d5c1c179fabdf4d16ee3f7898b5f1aa44491d60e624
MD5 1913846d5b49ae385ebd7010be41ca4a
BLAKE2b-256 261e4a4bfb5783e203e007eb8619e4c8171843c8140d29679970fac0ac68e9a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 dc2c4b0e7c367efa6253fffd3b2a75117fe704d9879a03dae949f63822493c21
MD5 e40f25ea7990d373215ff1fab46cbc56
BLAKE2b-256 3249d5b1e57a837eea1669305ca000bc26e2cbab12d03660ec0ef61ab5ca3b63

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm Hash digest
SHA256 ff5ad70ba05cceeeaaca2a588d4520b4f01142271e3dfa932b4dbb12c379903d
MD5 8439e487cd7eaddba6d679f27f157aca
BLAKE2b-256 6a40105d2eb235d44127134fc1470cb68f854566e273079abec0aee8cfbf0311

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e8622c0ecb3ce33c7a48ed428071ff735a6b3c88c1e1ce088104854d210707a8
MD5 cbf22677cd684b218a73da9f27c70f9a
BLAKE2b-256 616f6376dd7d17f9e0617a881b7ecc7fd1550e7b7d2c2f455261d52fa07261a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-macosx_11_0_arm64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file geotrace_sdk-0.5.1-cp312-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.1-cp312-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 9fc374256eaae41f07b955a7c1e9263649707e305e16ec722769275d4ef1f88d
MD5 aa229b7cbc475cda4892ea609f439785
BLAKE2b-256 b87d7151369dee5e4348e04daadd38fa774c90eb9bc27a9aea63f485bf709665

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.1-cp312-abi3-macosx_10_12_x86_64.whl:

Publisher: release-sdk.yml on CramBL/geotrace

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page