Identification de bâtiment

Ce endpoint permet d'identifier le bâtiment correspondant à une série de critères. Il permet d'accueillir des données imprécises et tente de les combiner pour fournir le meilleur résultat.

Endpoint

GET https://rnb-api.beta.gouv.fr/api/alpha/buildings/guess/

Filtres de recherche

Les filtres de recherche sont à transmettre sous forme de paramètres d’url.

Exemple :

GET https://rnb-api.beta.gouv.fr/api/alpha/buildings/guess?address=10+rue+de+la+paix+mérignac

Détails des filtres disponibles

Paramètre	Format	Défaut	Commentaire
address	string	null	Utilise les geocoders de la Base Adresse Nationale (via leur API) et d'Open Street Map (Photon) pour tenter de géolocaliser l'adresse indiquée. exemple : 1 rue de la paix, Mérignac
name	string	null	Utilise un geocoder Open Street Map (Photon) pour tenter de géolocaliser le lieu donné. exemple : Notre Dame de Paris
point	string. Latitude et longitude séparées par une virgule	null	Favorise les bâtiments en fonction de leur position par rapport au point indiqué. exemple : 44.84114313595151,-0.5705289444867035
page	int	1	Pagination des résultats de recherche

Exemple de réponse

 [
    {
        "rnb_id": "QBAAG16VCJWA",
        "score": 0.753986390, # La signification et le calcul du score est détaillé ci-dessous
        "status": "constructed",
        "point": {
            "type": "Point",
            "coordinates": [
                3.584410393780201,
                49.52799819019749
            ]
        },
        "addresses": [
            {
                "id": "02191_0020_00003",
                "source": "bdnb",
                "street_number": "3",
                "street_rep": "",
                "street_name": "de l'eglise",
                "street_type": "rue",
                "city_name": "Chivy-lès-Étouvelles",
                "city_zipcode": "02000",
                "city_insee_code": "02191"
            }
        ],
        "ext_ids": [ 
            {
                "id": "bdnb-bc-3B85-TYM9-FDSX",
                "source": "bdnb",
                "created_at": "2023-12-07T13:20:58.310444+00:00",
                "source_version": "2023_01"
            }
        ]
    },
    {
        "rnb_id": "GT5Y98K4BV51",
        "score": 0.1405659
        "status": "constructed",
        "point": {
            "type": "Point",
            "coordinates": [
                6.269684,
                43.89756654
            ]
        },
        "addresses": [
            {
                "id": "02191_0020_00005",
                "source": "bdnb",
                "street_number": "5",
                "street_rep": "",
                "street_name": "de l'eglise",
                "street_type": "rue",
                "city_name": "Chivy-lès-Étouvelles",
                "city_zipcode": "02000",
                "city_insee_code": "02191"
            }
        ],
        "ext_ids": [ 
            {
                "id": "bdnb-bc-3B86-TYM9-FRTS",
                "source": "bdnb",
                "created_at": "2023-12-07T13:25:58.310444+00:00",
                "source_version": "2023_01"
            }
        ]
    },
    // ... tous les autres résultats de la recherche
]

Signification et calcul du score

Les résultats de l'identification sont triés par score décroissant. Le détail du calcul du score est détaillé dans la class `GuessBuilding` consultable sur notre repository Github.

1. Calcul d'un score absolu pour chaque bâtiment

Nous utilisons les inputs donnés dans la requête pour calculer un score absolu pour chaque bâtiment. Voici quelques exemples de signaux faisant monter le score d'un bâtiment :

• Le bâtiment est du même côté de la route que le point de la requête

• Le bâtiment est proche du point de la requête (avec un fort bonus si le point est *sur* le bâtiment)

• Le bâtiment a le même identifiant BAN que celui retourné par l'API de la Base Adresse Nationale

• etc ...

A la fin de cette étape le score de chaque bâtiment varie généralement entre 0 et 20 mais fondamentalement le score absolu n'a pas de limite haute.