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.
- 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
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
https://docs.investigraph.dev/lib/ftm-geocode
Required external is libpostal, see installation instructions there.
Once libpostal is installed on your system, you can install:
pip install ftm-geocode[postal]
make install
make test
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.