DVF+ open-data

Présentation

apifoncier permet d’interroger librement les mutations issues de DVF selon le modèle de données du Cerema. Plus de détails sur DVF+

Les données proposées sont disponibles sous forme de dataframe ou geodataframe, accessible soit via le code insee de la commune ou une emprise geographique.

Import

Pour importer le module correspondant :

import apifoncier.dvf_opendata as dvf

Description des fonctions

apifoncier.dvf_opendata.mutations(code_insee=None, in_bbox=None, lon_lat=None, fields=None, ordering=None, anneemut_min=None, anneemut_max=None, anneemut=None, codtypbien=None, idnatmut=None, sbati_min=None, sbati_max=None, sterr_min=None, sterr_max=None, valeurfonc_min=None, valeurfonc_max=None, vefa=None)[source]

Retourne les mutations issues de DVF+ opendata pour le périmètre demandée sous forme d’un dataframe

Args:

code_insee (str or list, optional): Codes INSEE communaux ou des arrondissements municipaux. Defaults to None.

in_bbox (list, optional): Emprise rectangulaire sous la forme d’une liste [longitude_min, latitude_min, longitude_min, latitude_max] - Maximum 0.02 deg x 0.02 deg. Defaults to None.

lon_lat (list, optional): Coordonnée du point au sein de la ou des mutations renvoyées [longitude, latitude]. Defaults to None.

fields (str, optional): Mettre à « all » pour obtenir tous les champs associés. Defaults to None.

ordering (str, optional): Champs à utiliser pour ordonner le résultat. Defaults to None.

anneemut_min (str, optional): Année de mutation minimale. Defaults to None.

anneemut_max (str, optional): Année de mutation maximale. Defaults to None.

anneemut (str, optional): Année de mutation. Defaults to None.

codtypbien (str, optional): Code(s) de la typologie de bien à sélectionner (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None.

idnatmut (str, optional): Code(s) de nature de mutation (il est possible d’en demander plusieurs en séparant par une virgule. Defaults to None.

sbati_min (int, optional): Surface batie minimale. Defaults to None.

sbati_max (int, optional): Surface batie maximale. Defaults to None.

sterr_min (int, optional): Surface de terrain minimale. Defaults to None.

sterr_max (int, optional): Surface de terrain maximale. Defaults to None.

valeurfonc_min (int, optional): Valeur foncière minimale. Defaults to None.

valeurfonc_max (int, optional): Valeur foncière maximale. Defaults to None.

vefa (str, optional): vente en l’état futur d’achevement. Defaults to None.

Returns:

dataframe: données sur les mutations issues de DVF+ opendata

Examples:
>>> import apifoncier.dvf_opendata as dvf
>>> dvf.mutations(code_insee="59001")
>>> dvf.mutations(in_bbox=[3, 50, 3.01, 50.01], fields="all")
>>> dvf.mutations(code_insee=["59350", "59646"], valeurfonc_min=1000000)
apifoncier.dvf_opendata.geomutations(code_insee=None, in_bbox=None, lon_lat=None, fields=None, ordering=None, anneemut_min=None, anneemut_max=None, anneemut=None, codtypbien=None, idnatmut=None, sbati_min=None, sbati_max=None, sterr_min=None, sterr_max=None, valeurfonc_min=None, valeurfonc_max=None, vefa=None)[source]

Retourne les mutations issues de DVF+ opendata pour le périmètre demandée sous forme d’un geodataframe

Args:

code_insee (str or list, optional): Codes INSEE communaux ou des arrondissements municipaux. Defaults to None.

in_bbox (list, optional): Emprise rectangulaire sous la forme d’une liste [longitude_min, latitude_min, longitude_min, latitude_max] - Maximum 0.02 deg x 0.02 deg. Defaults to None.

lon_lat (list, optional): Coordonnée du point au sein de la ou des mutations renvoyées [longitude, latitude]. Defaults to None.

fields (str, optional): Mettre à « all » pour obtenir tous les champs associés. Defaults to None.

ordering (str, optional): Champs à utiliser pour ordonner le résultat. Defaults to None.

anneemut_min (str, optional): Année de mutation minimale. Defaults to None.

anneemut_max (str, optional): Année de mutation maximale. Defaults to None.

anneemut (str, optional): Année de mutation. Defaults to None.

codtypbien (str, optional): Code(s) de la typologie de bien à sélectionner (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None.

idnatmut (str, optional): Code(s) de nature de mutation (il est possible d’en demander plusieurs en séparant par une virgule. Defaults to None.

sbati_min (int, optional): Surface batie minimale. Defaults to None.

sbati_max (int, optional): Surface batie maximale. Defaults to None.

sterr_min (int, optional): Surface de terrain minimale. Defaults to None.

sterr_max (int, optional): Surface de terrain maximale. Defaults to None.

valeurfonc_min (int, optional): Valeur foncière minimale. Defaults to None.

valeurfonc_max (int, optional): Valeur foncière maximale. Defaults to None.

vefa (str, optional): vente en l’état futur d’achevement. Defaults to None.

Returns:

geodataframe: données sur les mutations issues de DVF+ opendata avec les contours géométriques

Examples:
>>> import apifoncier.dvf_opendata as dvf
>>> dvf.geomutations(code_insee="59001")
>>> dvf.geomutations(in_bbox=[3, 50, 3.01, 50.01], fields="all")
>>> dvf.geomutations(code_insee=["59350", "59646"], valeurfonc_min=1000000)
apifoncier.dvf_opendata.mutation(idmutation=None)[source]

Renvoi la mutation correspondant à l’identifiant idmutation (str)

Returns:

dataframe: donnée sur la mutation issue de DVF+ opendata

Exemples

La rubriques Exemples présente des usages de ce module : Exemples sur DVF+ open-data