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.0.tar.gz (140.7 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.0-cp312-abi3-win_arm64.whl (609.3 kB view details)

Uploaded CPython 3.12+Windows ARM64

geotrace_sdk-0.5.0-cp312-abi3-win_amd64.whl (638.0 kB view details)

Uploaded CPython 3.12+Windows x86-64

geotrace_sdk-0.5.0-cp312-abi3-win32.whl (613.0 kB view details)

Uploaded CPython 3.12+Windows x86

geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_x86_64.whl (912.9 kB view details)

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

geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_i686.whl (947.0 kB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ i686

geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_armv7l.whl (961.8 kB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARMv7l

geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_aarch64.whl (843.4 kB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARM64

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (695.1 kB view details)

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

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl (741.7 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ s390x

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (771.8 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ppc64le

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (685.5 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ARMv7l

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (666.1 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.17+ ARM64

geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl (749.9 kB view details)

Uploaded CPython 3.12+manylinux: glibc 2.5+ i686

geotrace_sdk-0.5.0-cp312-abi3-macosx_11_0_arm64.whl (639.7 kB view details)

Uploaded CPython 3.12+macOS 11.0+ ARM64

geotrace_sdk-0.5.0-cp312-abi3-macosx_10_12_x86_64.whl (676.0 kB view details)

Uploaded CPython 3.12+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: geotrace_sdk-0.5.0.tar.gz
  • Upload date:
  • Size: 140.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.5.0.tar.gz
Algorithm Hash digest
SHA256 05ccbfda315cb0dc2006c8e8293796639e81f202c568943f8bece4f1778fcb21
MD5 03271efd3d9f65400d67bdbae891fde7
BLAKE2b-256 987281696036bed2965d009a8cbb4e71369e828c39f9c279aaafb436ee656339

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0.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.0-cp312-abi3-win_arm64.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.0-cp312-abi3-win_arm64.whl
  • Upload date:
  • Size: 609.3 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.0-cp312-abi3-win_arm64.whl
Algorithm Hash digest
SHA256 e63a6a490755f304ae9162f2836e541521daf7501038ef91fda90464d050ed64
MD5 277917a2caff2976b30328a06bc61903
BLAKE2b-256 4d0480c31ce44536c71feb284bf1b2c689b5a2bc0d39c79adbf8c7dc353aa403

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-win_amd64.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.0-cp312-abi3-win_amd64.whl
  • Upload date:
  • Size: 638.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.0-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 6b7e43558e6172ce6bafbf3be08dc85639f6bd25913823782d193673fbd922d6
MD5 17c0d9b22d5843ccfbc562d63203d652
BLAKE2b-256 6a220a420c7bd64cdabb4ddd75424e19ee84ae1b374e2b18c7f1aaba7bc0a42e

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-win32.whl.

File metadata

  • Download URL: geotrace_sdk-0.5.0-cp312-abi3-win32.whl
  • Upload date:
  • Size: 613.0 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.0-cp312-abi3-win32.whl
Algorithm Hash digest
SHA256 9c4f1feeb43dcf7ea4ed8b71bccdb71d55e97d6d881b2976be8ed2b44ceedf0d
MD5 cebac02b9b2f27ff197920d9d1f0d20a
BLAKE2b-256 7c87921b5d2d2e308f8ed94ba18ad383f96cb398846ef37f0b63571371fea3cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 8f83669bc832fe3d022e73b06ddd9c36a8530b8823ab1831f9342788501b886b
MD5 067472f10a7e982fbe0d205bfb225a04
BLAKE2b-256 0abdf04ecfa7c8ae299629d71b3b7f26f8b5c33a5a40a962c85e46b9c8e4dda5

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-musllinux_1_2_i686.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_i686.whl
Algorithm Hash digest
SHA256 3a016a51bb85d0587bc3e536f87f5dcfc9bbfcf54d98c78355331cae419a6ea9
MD5 68bfd7c90002b393cd019d31d5c008c2
BLAKE2b-256 c1733e8033127f3ad842634afbafe3aeb9607e33d0778d5fea4ea6313c45593f

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-musllinux_1_2_armv7l.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_armv7l.whl
Algorithm Hash digest
SHA256 6006764cbb69c8b371dbda194962b182405506fce630e00d30065e6e5376a999
MD5 127ddf55455c19ec9f2c8cbed149fee9
BLAKE2b-256 7756f91c8fdec014f69656bee69664c460994cedf9ce49adf75c8f94c3a2b799

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 77a0b3a171eea4aaed795c18ac952585e447ebd8b4821eeec3619e27ac3ab7ca
MD5 03503d27f363537e9ffc32ef43a6cd33
BLAKE2b-256 e9980d991f263c18bdd810125eade1fcc1b7dec90727964339f376e944832338

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e36506b91f0c3f9224215d5305852e84909581a4a599a171df8d9f1704c2c927
MD5 eab82d0b5828ea1fc4ca9cf721a14d5a
BLAKE2b-256 712f93b254de82a6a00fed5dfbc819ff231ece4f12b58fdd95749e2e5b4f31bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl
Algorithm Hash digest
SHA256 885eedab355ff7db2661a090e93c0749788b930a50d20ea96d8d0d7c69b42614
MD5 981ad1881d8101291d51290fd4f22c9a
BLAKE2b-256 3319c4d53cc02eee3dbf9fd573ffc308893d0df987d7ddb040f52832b6815b9f

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Algorithm Hash digest
SHA256 b2c87890e9f1b45dc561e57ed48cc2d32604fb2ef9d99e0950754126d4eb7d3f
MD5 4c94d3ad9b253ac9913aaa3dc7d98032
BLAKE2b-256 f7c973f5a8b7b8b8fee3428d26dffedf0488022425d59e0394de1ce899dcc478

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm Hash digest
SHA256 4ba400b310c79dc3741d696a0020d2c1025f87cfa770662cc9ee288b0e7fd088
MD5 83781970354223da692477e5ac11c4e6
BLAKE2b-256 da2796e8035d451e67a290f6e10e2767bfde83eb1d51b7e6c18d4d15d1efb3f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 06088fedb976104bc7396337b824fc71421c6c7f3971b3dda7be9d5dcebb6acc
MD5 6abbe601488b16510fcc555645e1334c
BLAKE2b-256 f3572e1b4c6915f774a239097eae1897fb5647e6d5434d3d2bca4ffd527ac27e

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm Hash digest
SHA256 5d522a332a08fa4bd4048771dce50fc1362c7d992f8b643b1c682aa2411eacfb
MD5 184e43481b022039e43a8a1c967280ff
BLAKE2b-256 cc9db9ef86f7acd311efacccc64f0c7b6c9c34d584528d197ef7a85223e7fbfb

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7823fe833fee1f23473467e69243f5947184f053c41f0859bbe9e8a503f8833a
MD5 167ba6279a9ad0fab6d88c2cea87565a
BLAKE2b-256 cd1c31d6c75b90c2944ac13d1362d307d68397cbd4e49cc0c4474278dcbecac2

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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.0-cp312-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for geotrace_sdk-0.5.0-cp312-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 d7d60ee58ffd323d3128b0639d534a2a918af71f1f8c984131f64494369c9053
MD5 9dbfd52ccc2b346c5c400ca7c3f86181
BLAKE2b-256 d0a5ed702f4c1bc2f9915b99175a3ef52144908aca1118fde03432fa5b408f9d

See more details on using hashes here.

Provenance

The following attestation bundles were made for geotrace_sdk-0.5.0-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