Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

A5 - Global, equal-area, millimeter-accurate geospatial index

Website: A5Geo.org

thumbnails

Introduction

A5 is a geospatial index that partitions the world into pentagonal cells. The cells are available at 31 different resolution levels, with the largest cell covering the whole world, and the smallest less than 30mm². Within each resolution level the cells have equal area, as per the OGC definition.

A5 cells provide simple way to represent spatial data as a collection of cells, which together represent regions on the globe. These can be anything, from city districts to parcels of land. Once data is in a cell-based format, it becomes much simpler to perform analysis such as calculating the correlation between different variables - for example elevation and crop yield.

Cells can also be used to group (aggregate) point data, to understand how it spatially distributed. For example, the density of holiday rentals across a city.

To understand how it works, take a look at the Examples.

A5 is implemented in TypeScript and is available as a library, with API documentation here. It is open source and licensed under the Apache 2.0 License.

Benefits over alternative systems

Like other DGGSs, A5 can be used for indexing, spatial joins, and other spatial operations. The appropriate choice of DGGS will depend on the use case, the key strengths of A5 over other similar indexing systems are:

  • Equal area cells group spatial features without introducing bias.
  • Very high resolution of 30mm² at final resolution level, encoded as a 64-bit integer.
  • Single cell topology type, with minimal shape distortion across the globe.

Geometric Construction

DGGSs are generally based on a planar cell tiling which is applied to the sides of a platonic solid, before being projected onto a sphere.

A5 is unique in that it uses a pentagonal tiling of a dodecahedron. The pentagon chosen for the tiling is equilateral, but not regular - unlike other common DGGSs which use regular polygons, for example HTM uses triangles, S2 uses squares, and H3 uses hexagons.

The benefit of choosing a dodecahedron is that it is the platonic solid with the lowest vertex curvature, and by this measure it is the most spherical of all the platonic solids. This is key for minimizing cell distortion as the process of projecting a platonic solid onto a sphere involves warping the cell geometry to force the vertex curvature to approach zero. Thus, the lower the original vertex curvature, the less distortion will be introduced by the projection.

Metadata

Release files for pya5 1.0.0b3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pya5 1.0.0b3
File Size Uploaded
pya5-1.0.0b3.tar.gz 125.9 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for pya5 1.0.0b3
File
pya5-1.0.0b3-py3-none-any.whl Python 3 none any Details
pya5-1.0.0b3-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details
pya5-1.0.0b3-cp38-abi3-musllinux_1_2_x86_64.whl CPython 3.8 abi3 Linux musl 1.2+ x86-64 Details
pya5-1.0.0b3-cp38-abi3-musllinux_1_2_aarch64.whl CPython 3.8 abi3 Linux musl 1.2+ ARM64 Details
pya5-1.0.0b3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details
pya5-1.0.0b3-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details
pya5-1.0.0b3-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details
pya5-1.0.0b3-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details

Total release size: 3.6 MB

Release files / pya5-1.0.0b3.tar.gz

Download URL pya5-1.0.0b3.tar.gz
Size 125.9 kB
Tags Source
SHA-256 checksum
How to use checksums
76a5237a1c5236fa81e62d11b326ee3f4183786fee13f93e36bb38db1470d9cb
BLAKE2b-256 checksum
How to use checksums
1d6b2ed2bca7115997d58a986c44246db5e808e9b1d295eddedc5b604c59063a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-py3-none-any.whl

Download URL pya5-1.0.0b3-py3-none-any.whl
Size 133.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
35a8f7cee03ca7ed4b176028237cc4f0e1e093dfa4c2421fa1d7273df426031f
BLAKE2b-256 checksum
How to use checksums
ad9b47a4ef378dbd5ec8405719ca08024ca511d556c7bd0c18fe10ae556bb5b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-win_amd64.whl

Download URL pya5-1.0.0b3-cp38-abi3-win_amd64.whl
Size 391.0 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
eeeec4611caeb8da84f1e5538dfe81284c55c2199867b1edc3404a21e3cffc66
BLAKE2b-256 checksum
How to use checksums
cd987e449c3629a2bad489fae643ba94f92588aa03ad1717b9163a8971960704
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-musllinux_1_2_x86_64.whl

Download URL pya5-1.0.0b3-cp38-abi3-musllinux_1_2_x86_64.whl
Size 557.7 kB
Tags CPython 3.8 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum
How to use checksums
cae448039269bb0b145939b7e102e09ba6f7f549ebbb9872357dea46b3ec5e78
BLAKE2b-256 checksum
How to use checksums
0096971b25ab59982c7c7a7a80b825180e4d6083dfd4d0794e140676ccc7fbac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-musllinux_1_2_aarch64.whl

Download URL pya5-1.0.0b3-cp38-abi3-musllinux_1_2_aarch64.whl
Size 522.0 kB
Tags CPython 3.8 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum
How to use checksums
73760c3f7144cd38e4c59fddcc1fd12979429067e0d5674a677b753ebeaf9e9a
BLAKE2b-256 checksum
How to use checksums
a6a1c00aa3ee4c05a81570d1b78bc2e79bfb89cc5e924165991f726d94d19b8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL pya5-1.0.0b3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 478.2 kB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
aace8844eda33f20405d90b6b61951f4303b059748d759cb610b26f4eacb444e
BLAKE2b-256 checksum
How to use checksums
a942db5039152c1f075e0eddfbc92b0ab019ef240409d870906acccef9a6cee5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL pya5-1.0.0b3-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 456.6 kB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
5e52b293b1bb9f8d321b6f6d6331413cdf524d4872642f774e48cd94b53b2b8f
BLAKE2b-256 checksum
How to use checksums
ca07b722c633c66d54fd36e4457c878720560e5d9266343000e5b1462dadc765
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-macosx_11_0_arm64.whl

Download URL pya5-1.0.0b3-cp38-abi3-macosx_11_0_arm64.whl
Size 437.2 kB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
89b133dc7e5dd6c63786bf0df0a0a6e9b51fd9e90116d3cddd11da8610cd39d8
BLAKE2b-256 checksum
How to use checksums
407bfae6ba83fa6456d25e413f73b99a7dfae7abcad5e10710546071f112ffe9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / pya5-1.0.0b3-cp38-abi3-macosx_10_12_x86_64.whl

Download URL pya5-1.0.0b3-cp38-abi3-macosx_10_12_x86_64.whl
Size 463.6 kB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
e93dba9ba3a7b117b6dd42342abb3e1a2ae7fbc032c8fc8ae356630931b87ee9
BLAKE2b-256 checksum
How to use checksums
637c689eed44a64103f5f1a2b7e8e4aef891a9e09131ccd2a1bd593865df78d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page