API et dictionnaire des données

Le ministère de la Culture met à disposition une API REST permettant de lire les données de la plateforme : https://basedeslieux.culture.gouv.fr/api

Pour commencer à utiliser l'API, envoyez une demande à webmaster@culture.gouv.fr

Structure des données

La structure des données sur le lieu est composée de 3 parties :

Structure / champs d'identification
Catégorie(s) culturelle(s)
Informations

Identifiants

Voici la liste complète des identifiants :

Nom fonctionnel	Description	Nom de la table	Nom du champ	Format	Exemple
Identifiant Unique du lieu	Identifiant unique du lieu	t_place	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d9
Identifiant sous-domaine	Identifiant unique du sous-domaine	t_subdomain	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d10
Domaine du sous-domaine	Identifiant unique du domaine	t_subdomain	domain_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d11
identifiant type	Identifiant unique du type	t_type	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d12
Sous-domaine du type	Identifiant unique du sous-domaine	t_type	subdomain_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d13
identifiant label	Identifiant unique du label	t_label	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d14
Sous-domaine du label	Identifiant unique du sous-domaine	t_label	subdomain_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d15
identifiant sous-domaine informations	Identifiant unique du subdomainInformation (ce qui lie les info de sous-domaine à un lieu)	t_subdomain_informations	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d16
id du lieu	Identifiant unique du lieu (permet la liaison)	t_subdomain_informations	place_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d17
id du domaine	Identifiant unique du domaine (permet la liaison)	t_subdomain_informations	domain_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d18
id du sous-domaine	Identifiant unique du sous-domaine (permet la liaison)	t_subdomain_informations	subdomain_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d19
id de la date labélisation	Identifiant unique du labelDate (ce qui lie une date à un label d'un subdomainInformation)	t_label_date	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d20
id du lieu	Identifiant unique du lieu (permet la liaison)	t_label_date	place_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d21
id du label	Identifiant unique du label (permet la liaison)	t_label_date	label_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d22
id du sous-domaine-informations	Identifiant unique du subdomainInformation (permet la liaison)	t_label_date	subdomain_information_id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d23
id utilisateur	Identifiant unique de l'utilisateur	t_user	id	UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d24

Champs d'identification du lieu

Voici la liste complète des champs définissant le nom du lieu et sa localisation :

Nom fonctionnel	Description	Nom de la table	Nom du champ	Exemple
Nom	Nom du lieu	t_place	name	Ex: Fortifications
Nom usuel	Nom courant du lieu	t_place	usual_name	Ex: Fortifications de Vauban
Entité juridique de rattachement	Nom de l'établissement administratif dont le lieu dépend	t_place	juridical_entity	Ex: COMMUNE DE BRIANCON
Numéro de SIRET	Le numéro SIRET (Système d'Identification du Répertoire des Établissements) correspond à une série de 14 chiffres servant à répertorier les entreprises françaises.	t_place	siret_number	Ex: 21050023700016
Adresse complète	Adresse complète administrative ou légale	t_place	address_complete	Ex: 43 Rue Aspirant Jan, 05100 Briançon
Adresse de l'entrée du public	Se compose du numéro et du libellé de la voie, du code postal, du nom de la commune et du pays	t_place	address	Ex: Porte de Pignerol, 05100 Briançon, France
Numéro et libellé de la voie	Numéro et libellé de la voie	t_place	address_short	Ex: Porte de Pignerol
Complément d'adresse	Précision de l'adresse du lieu (Mention spéciale lieu-dit)	t_place	address_precision	Ex: BP ( Boite Postale) ou CS ( Course spéciale )
Code Postal	Code postal du lieu	t_place	zipcode	Ex: 05100
Commune	Nom de la commune du lieu	t_place	city	Ex: Briançon
Autres communes	Autres communes rattachées au lieu	t_place	other_cities	Ex: Lieu-dit
Code Insee	Code Insee du lieu	t_place	insee_code	Ex: 05023
Code Insee Arrondissement	Code Insee Arrondissement	t_place	insee_sub	Ex: 051
Département	Nom du Département du lieu	t_place	department	Ex: Hautes-Alpes
Code Insee département	Code Insee du département du lieu	t_place	insee_department	Ex: 05
Région	Nom de la Région du lieu	t_place	region	Ex: Provence-Alpes-Côte d'Azur
Code Insee Region	Code Insee de la région du lieu	t_place	insee_region	Ex: 93
Pays	Pays du lieu	t_place	country	Ex: France
Latitude	Coordonnée géographique de latitude du lieu	t_place	latitude	Ex: 44.899461
Longitude	Coordonnée géographique de longitude du lieu	t_place	longitude	Ex: 6.642914
Point terrestre	Un point servant à faire des recherche par distance par rapport à un lieu	t_place	earth_point	Ex : 0101000020E6100000566FC3DE7AA302404E57C1B9D0704840

Champs des Catégories culturelles

Voici la liste complète des champs définissant les catégories culturelles rattachée au lieu :

Nom fonctionnel	Description	Nom de la table	Nom du champ	Règles de gestions	Exemple
Nom domaine	Liste des domaines du lieu	t_domain	name	6 domaines peuvent décrire un lieu : Archives, Arts du spectacle, Arts visuels, Cinéma et audiovisuel, Éducation et formation, Lecture, livre et presse, Patrimoine	Ex: Patrimoine
Nom public du domaine	Liste des domaines du lieu avec un intitulé compréhensible pour le grand public	t_domain	name_public		Ex : Patrimoine
Nom sous-domaine	Liste des sous-domaines du lieu	t_subdomain	name	Un sous domaine appartient à un domaine	Ex: Monument et Architecture
Nom public du sous-domaine		t_subdomain
Label d'importation (sous-domaine)	champs permettant de déterminer rapidement à quel domaine/sous-domaine appartient un type ou label	t_subdomain	import_label	concaténation automatique des champs "name" parents + celui de l'objet (s'applique aux domaines, sous-domaines, types, labels)	Arts du spectacle::Musique::Scène
Nom du type	Nom du type du sous-domaine	t_type	name	Un type appartient à un sous domaine	Ex: Architecture militaire
Nom public du type		t_type
Label d'importation (type)	champs permettant de déterminer à quel domaine/sous-domaine appartient un type	t_type	import_label	concaténation automatique des champs "name" parents + celui de l'objet (s'applique aux domaines, sous-domaines, types, labels)	Arts du spectacle::Musique::Scène
Nom du label	Nom de la protection, du label ou de l'appellation du sous-domaine	t_label	name	Le champs Protections, labels et appellation appartient à un sous domaine.	Ex: Monument historique inscrit
Nom public du label		t_label
Label d'importation (label)	champs permettant de déterminer à quel domaine/sous-domaine appartient un label	t_label	import_label	concaténation automatique des champs "name" parents + celui de l'objet (s'applique aux domaines, sous-domaines, types, labels)	Arts du spectacle::Musique::Scène
Liste des types	Liste des types du sous-domaine	t_subdomain_informations	types	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [''c65cd385-5000-4305-845c-a26071e153e0'', ''9e1d9ef3-794b-4997-a0ba-eae77a177bef'']	Ex: Architecture militaire, Génie civil
Liste des labels	Liste des protections, labels et appellation du sous-domaine	t_subdomain_informations	labels	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [''a5e9fbb1-cf76-49ff-af89-f033c44aec68'', ''b2e9fbb1-cf76-49ff-af89-f033c44aec68'']	Ex: Monument historique inscrit, situé dans un espace inscrit à l'UNESCO
Année d'obtention	Année d'obtention de la protection, du label ou de l'appellation	t_label_date	labeling_date	Lié au champ Protections, labels ou appellation	Ex: 1950
Description	Description du lieu par rapport au sous-domaine concerné	t_subdomain_informations	description		Ex: Occupant une position stratégique à 1326 mètres d'altitude, la ville haute de Briançon, juchée sur un piton rocheux, s'impose comme un site unique de fortification de montagne. Enserrée dans des remparts projetés par Vauban, elle est, elle-même, couronnée par des forts d'altitude la rendant imprenable.
Image	Image du lieu par rapport au sous-domaine concerné	t_subdomain_informations	image	Deux façons de contribuer : - Télécharger le fichier image depuis l'ordinateur - Saisir l'URL de l'image (Préfixé par https:// ou http://)
Mentions légales	Légende et crédits de l'image	t_subdomain_informations	caption	Lié au champ Image	Ex: Vue de la citadelle © Mairie de Briançon
Cession d'autorisation d'usage de l'image		t_subdomain_informations	sharable	Lié au champs Image et Mentions légales
Nom de l'auteur/illustre	Noms des auteurs ou illustres du sous-domaine (ex : illustre du label Maison des illustres, architectes du monument ou du jardin, etc.)	t_subdomain_informations	illustrate_name		Ex: Ferdinand Cheval pour le Palais Idéal - Villa Alicius
Nombre de places	Indique le nombre de places disponibles dans le sous-domaine concerné	t_subdomain_informations	number_of_seat		Ex: 87
Identifiant DEPS	Identifiant (créé par le DEPS) du lieu de la base métier source	t_subdomain_informations	deps_id		Ex: MONH_05023_0015
Identifiant d'origine	Identifiant du lieu de la base d'origine	t_subdomain_informations	origin_id		Ex: PA00080535
Source	Identifie le nom de la source de la donnée	t_subdomain_informations	origin_source		Ex: Médiathèque de l'architecture et du patrimoine

Informations

Voici la liste complète des champs définissant les informations pratiques et indicateurs :

Nom fonctionnel	Description	Nom de la table	Nom du champ	Règles de gestions	Exemple
Site internet et autres liens	Site internet et réseaux sociaux du lieu	t_place	website	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [‘https://www.culture.gouv.fr’, ‘https://basedeslieux.culture.gouv.fr’]	Ex: https://www.ville-briancon.fr/les-fortifications-de-vauban
Téléphones	Numéros publics du lieu	t_place	phone	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [‘0140150000’, ‘0140158000’]	Ex: +33492202949
Courriels	Courriels publics du lieu	t_place	email	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex: [‘ [email protected]’, ‘[email protected]’]	Ex: [email protected]
Accessible au public	Définit les conditions d'accès au public	t_place	accessible_to_public	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [‘Ouvert’, ‘fermé’, ‘visible depuis la voie publique’, ‘Accès Handicap’]	Ex: Ouvert
Conditions d'ouverture	Définit les conditions d'ouverture du lieu	t_place	opening_condition	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : [ ‘A l'année', 'saisonnière', 'de jour', 'de nuit', 'en travaux']	Ex: de jour
Livraison	Indique si le lieu effectue des livraisons	t_place	delivery		Ex: Oui
Retrait sur place	Indique si l'utilisateur peut retirer sur place (ex: des livres)	t_place	pick_up_on_site		Ex: Oui
Accueil du public sur rendez-vous	Indique si le lieu offre des événements sur inscription/réservation	t_place	reception_public_by_appointment		Ex: Oui
Condition d'accès	Indique les conditions d'accès au lieu	t_place	access_condition	Limité à 500 caractères dans le formulaire de contribution	Ex : Parking gratuit
Superficie / surface	Surface du lieu en m²	t_place	area		Ex: 2000
Nombre de salles	Indique le nombre de salles existantes dans le lieu concerné	t_place	number_of_room		Ex: 10
Catégories d'ERP	Indique le nombre de personnes pouvant etre présent dans le lieu	t_place	number_of_people	Le type est désigné par un chiffre. choix unique parmi une liste : 1 (plus de 1500 pers.) \| 2 (de 701 à 1500 pers.) \| 3 (de 301 à 700 pers.) \| 4 (jusqu'à 300 pers.) \| 5 (inférieur aux seuils fixés)	Ex: 2
Type d'ERP principal	Représente le type d'ERP principal du lieu	t_place	erp_principal	Le type est désigné par une lettre. choix unique parmi une liste https://entreprendre.service-public.fr/vosdroits/F32351	Ex: PA (Établissements de plein air)
Type d'ERP secondaire	Représente les types d'ERP secondaires du lieu	t_place	erp_secondary	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule choix multiple parmi une liste Le type est désigné par une lettre. https://entreprendre.service-public.fr/vosdroits/F32351	Ex: ['CTS', 'S'] (Bibliothèques ou centres de documentation)
Nombre d'écrans	Indique le nombre d'écrans dans le lieu concerné	t_place	number_of_screen		Ex: 5