ftm-geocode
Batch parse and geocode addresses from followthemoney entities. Simply geocoding just address strings works as well, of course.
There are as well some parsing / normalization helpers.
Features
- Parse/normalize addresses via libpostal
- Geocoding via geopy
- Cache geocoding results using anystore
- Optional fallback geocoders when preferred geocoder doesn't match
- Create, update and merge
Addressentities for ftm data
Quickstart
pip install ftm-geocode
Geocode an input stream of ftm entities with nominatim and google maps as fallback (geocoders are tried in the given order):
cat entities.ftm.ijson | ftmgeo geocode -g nominatim -g google > entities_geocoded.ftm.ijson
Documentation
https://docs.investigraph.dev/lib/ftm-geocode
Installation
Required external is libpostal, see installation instructions there.
Once libpostal is installed on your system, you can install:
pip install ftm-geocode[postal]
Testing
make install
make test
License and Copyright
ftm_geocode, (C) 2023 Simon Wörpel
ftm_geocode, (C) 2024-2025 investigativedata.io
ftm_geocode, (C) 2025 Data and Research Center – DARC
ftm_geocode is licensed under the AGPLv3 or later license.
Prior to version 0.1.0, ftm_geocode was released under the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for ftm-geocode 4.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ftm_geocode-4.3.0.tar.gz | 26.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ftm_geocode-4.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.2 kB
Release files / ftm_geocode-4.3.0.tar.gz
| Download URL | ftm_geocode-4.3.0.tar.gz |
|---|---|
| Size | 26.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f996c8538508deb9052b3092551e337938c565241f5f2e3444a35ff78eeee3a8
|
|
BLAKE2b-256 checksum How to use checksums |
48ac511bd5eb270c866d9f736b25f2c50e46dc6e137113342492f5707479edc9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.5 Linux/6.12.57+deb13-amd64
|
Release files / ftm_geocode-4.3.0-py3-none-any.whl
| Download URL | ftm_geocode-4.3.0-py3-none-any.whl |
|---|---|
| Size | 30.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb841d9a634ea540cde2236db275bb82507cd1eb78c434e6405058cb07574d28
|
|
BLAKE2b-256 checksum How to use checksums |
73a4e690addd0a612c87c02c329ab9251ff6c3293e5af8ac39195b5161c7ccc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.5 Linux/6.12.57+deb13-amd64
|
