Country

Geocode French addresses offline

One file for all of France, read locally. No server, no API key, and the addresses you geocode never leave your machine.

Get started

The file for France is 365 MB and holds 26.1 million addresses from the BAN national address registry. Download it once, checked against the signed release; every query after that runs on your machine, with no API key and no rate limit.

terminalpip
$ pip install gridpin-mcp   # includes the engine
$ gridpin-fetch fr         # France, 365 MB, verified download
geocode.pyPython
import gridpin
from gridpin_mcp import sheets

g = gridpin.Geocoder(str(sheets.download("fr")))  # no-op once downloaded

g.geocode("1 rue de la Paix, 75002 Paris", 1)
# -> house, Rue de la Paix 1, Paris 2e Arrondissement
g.geocode("8 Boulevard du Port, Amiens", 1)
# -> house, Boulevard du Port 8, Amiens

A query that says just Paris, Lyon or Marseille finds the address in its arrondissement. An optional points-of-interest layer for France (231 MB) is described in the documentation.

How often it finds the right house, compared with Nominatim and Photon on independent truth: benchmark. Try it without installing: the live demo (pick France in the list), or the Colab notebook (set COUNTRY = "fr").