Geocode or reverse-geocode any French address (official BAN, with confidence score)

French address geocoding on the official Base Adresse Nationale (api-adresse.data.gouv.fr, Etalab/IGN, continuously updated). Forward: ?q=8 boulevard du port amiens with optional &type=housenumber|street|locality|municipality &citycode=80021 (INSEE filter). Reverse: ?lat=49.897&lon=2.290. &limit=1-10 (default 3). Each match returns normalized label, confidence score, lat/lon, street, postcode, city, INSEE citycode and context. No match returns 400 (not billed). Cached 24h.

get/v1/fr/geocode

Request

  • Base URL: https://data.greeneris.io (the document declares no server; this is the origin it was published from)
  • URL: https://data.greeneris.io/v1/fr/geocode
  • Auth: none declared

Query parameters

qstring

Free-text French address (forward mode)

latnumber

Latitude (reverse mode, with lon)

lonnumber

Longitude (reverse mode, with lat)

type'housenumber' | 'street' | 'locality' | 'municipality'

Restrict match type

citycodestring

Filter by 5-char INSEE city code

limitinteger

Max matches, 1-10 (default 3)

Response

Successful response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.