Géocodeur France - API Adresse Officielle BAN

Overview

This actor converts French addresses into GPS coordinates (latitude/longitude) using the official French government API (Base Adresse Nationale, data.gouv.fr). It's designed for fast, reliable geocoding of addresses across metropolitan France and its overseas territories (DOM-TOM).

Key Features

• Official Data Source: Uses the authoritative French National Address Database (BAN).
• Fast Processing: Typically returns results in under one second per address.
• Rich Output: Returns not only coordinates but also normalized address components and quality scores.
• Broad Coverage: Handles addresses from mainland France and DOM-TOM (coverage may vary by territory).
• Coordinate Systems: Provides coordinates in both WGS84 (GPS) and the French Lambert 93 projection.

How to Use

Provide a French address as input. The actor queries the BAN API and returns structured geocoding results.

Input

The actor accepts a JSON object with a single required field.

{
  "adresse": "10 Rue de Rivoli, 75004 Paris"
}

• adresse (required): A complete or partial French address string.

Output

The actor returns a detailed JSON object. Key fields include:

Core Coordinates (WGS84):
* latitude, longitude: The primary GPS coordinates.

Normalized Address:
* adresse_formatee: The fully normalized official address.
* adresse_numero: Street address with number.
* rue, code_postal, ville, code_insee: Individual address components.

Geocoding Quality:
* type_resultat: Result type (housenumber, street, locality, municipality).
* score: Relevance score from 0 to 1 (scores >0.5 are considered reliable).

Identifiers & Projections:
* ban_id: Unique identifier from the BAN.
* x, y: Coordinates in the French Lambert 93 projection (meters).

Example Output:

{
  "adresse_entree": "8 Boulevard du Port 80000 Amiens",
  "latitude": 49.897442,
  "longitude": 2.290084,
  "adresse_formatee": "8 Boulevard du Port 80000 Amiens",
  "numero": "8",
  "rue": "Boulevard du Port",
  "code_postal": "80000",
  "ville": "Amiens",
  "code_insee": "80021",
  "type_resultat": "housenumber",
  "score": 0.97
}

Limitations & Notes

• Data Freshness: The database is updated monthly; very new streets may not be included.
• Input Precision: Incomplete addresses (e.g., missing house numbers) will result in lower precision geocoding.
• Proxy: The Apify proxy is optional and usually not required for this public government API.

Complementary Actors

Extend your geocoding results with these related actors:
* cadastre-france → Convert GPS coordinates to cadastral parcel data.
* adresse-cadastre → Geocode an address and retrieve its cadastral data in one step.
* dvf-historique → Get historical real estate transaction data by municipality.
* comparateur-immo → Compare property prices per square meter between communes.
* france-property-estimator → Estimate the value of a French property.