DV3F¶
Présentation¶
apifoncier permet d’interroger les mutations issues de DV3F, base de données enrichie
sur les marchés fonciers et immobiliers du Cerema.
Plus de détails sur DV3F
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.
Note
L’accès aux données DV3F nécessite d’appartenir à une structure publique bénéficiaire et d’avoir prélablement obtenu un jeton API. Rendez-vous sur ConsultDF pour plus d’informations.
Import¶
Pour importer le module correspondant :
## Configuration préalable du jeton API
import apifoncier
API_TOKEN = "<MON_TOKEN_API>"
apifoncier.configure(TOKEN=API_TOKEN)
import apifoncier.dv3f as dv3f
Description des fonctions¶
- apifoncier.dv3f.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, codtypprov=None, codtypproa=None, filtre=None)[source]¶
Retourne les mutations issues de DV3F 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 friches 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.
codtypprov (str, optional) : Code(s) de la typologie du vendeur (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None
codtypproa (str, optional) : Code(s) de la typologie de l’acheteur (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None
filtre (str, optional): Code alphanumerique permettant d’exclure des transactions particulières. Defaults to None.
- Returns:
dataframe: données sur les mutations issues de DV3F
- apifoncier.dv3f.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, codtypprov=None, codtypproa=None, filtre=None)[source]¶
Retourne les mutations issues de DV3F 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 friches 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.
codtypprov (str, optional) : Code(s) de la typologie du vendeur (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None
codtypproa (str, optional) : Code(s) de la typologie de l’acheteur (il est possible de ne specifier que les premiers niveaux et de séparer par une virgule). Defaults to None
filtre (str, optional): Code alphanumerique permettant d’exclure des transactions particulières. Defaults to None.
- Returns:
geodataframe: données sur les mutations issues de DV3F avec les contours géométriques