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)
Exemples¶
La rubriques Exemples présente des usages de ce module : Exemples sur DVF+ open-data