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	Longueur	Obligatoire(O)/ Facultatif (F)	Règles de gestions	Exemple
Identifiant Unique du lieu	Identifiant unique du lieu	t_place	id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d9
Identifiant sous-domaine	Identifiant unique du sous-domaine	t_subdomain	id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d10
Domaine du sous-domaine	Identifiant unique du domaine	t_subdomain	domain_id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d11
identifiant type	Identifiant unique du type	t_type	id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d12
Sous-domaine du type	Identifiant unique du sous-domaine	t_type	subdomain_id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d13
identifiant label	Identifiant unique du label	t_label	id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d14
Sous-domaine du label	Identifiant unique du sous-domaine	t_label	subdomain_id	Chaîne de caractères	36	O	Format 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	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d16
id du lieu	Identifiant unique du lieu (permet la liaison)	t_subdomain_informations	place_id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d17
id du domaine	Identifiant unique du domaine (permet la liaison)	t_subdomain_informations	domain_id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d18
id du sous-domaine	Identifiant unique du sous-domaine (permet la liaison)	t_subdomain_informations	subdomain_id	Chaîne de caractères	36	O	Format 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	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d20
id du lieu	Identifiant unique du lieu (permet la liaison)	t_label_date	place_id	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d21
id du label	Identifiant unique du label (permet la liaison)	t_label_date	label_id	Chaîne de caractères	36	O	Format 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	Chaîne de caractères	36	O	Format UUID	Ex : 684d0418-30c6-58af-b4b9-d6833aefd0d23
id utilisateur	Identifiant unique de l'utilisateur	t_user	id	Chaîne de caractères	36	O	Format 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	Format	Longueur	Obligatoire(O)/ Facultatif (F)	Règles de gestions	Exemple	Mapping
Nom	Nom du lieu	t_place	name	Chaîne de caractères	300	O		Ex: Fortifications
Nom usuel	Nom courant du lieu	t_place	usual_name	Chaîne de caractères	255	F		Ex: Fortifications de Vauban
Entité juridique de rattachement	Nom de l'établissement administratif dont le lieu dépend	t_place	juridical_entity	Chaîne de caractères	255	F	Exemple de requête : https://api.insee.fr/entreprises/sirene/V3/siret/<siretNumber>?champs=denominationUniteLegale	Ex: COMMUNE DE BRIANCON	Connecté avec API Insee : https://api.insee.fr/catalogue/site/themes/wso2/subthemes/insee/pages/item-info.jag?name=Sirene&version=V3&provider=insee
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	Nombre entier	14	F	Exemple de requête : https://api.insee.fr/entreprises/sirene/V3/siret/<siretNumber>?champs=denominationUniteLegale	Ex: 21050023700016	Connecté avec API Insee : https://api.insee.fr/catalogue/site/themes/wso2/subthemes/insee/pages/item-info.jag?name=Sirene&version=V3&provider=insee
Adresse complète	Adresse complète administrative ou légale	t_place	address_complete	Chaîne de caractères	255	F		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	Chaîne de caractères	255	F	Concaténation des champs address_short, zipcode et city	Ex: Porte de Pignerol, 05100 Briançon, France	Connecté avec api-adresse-data pour les adresses françaises + api wemap pour les adresses étrangères (https://api.getwemap.com/v3.0/geocoding/geocode)
Numéro et libellé de la voie	Numéro et libellé de la voie	t_place	address_short	Chaîne de caractères	500	O	Exemple de requête : /v3.0/geocoding/geocode?longitude=<long>&latitude=<lat>	Ex: Porte de Pignerol	Connecté avec api-adresse-data pour les adresses françaises + api wemap pour les adresses étrangères (https://api.getwemap.com/v3.0/geocoding/geocode)
Complément d'adresse	Précision de l'adresse du lieu (Mention spéciale lieu-dit)	t_place	address_precision	Chaîne de caractères	500	F		Ex: BP ( Boite Postale) ou CS ( Course spéciale )
Code Postal	Code postal du lieu	t_place	zipcode	Chaîne de caractères	255	O	Exemple de requête : /v3.0/geocoding/geocode?longitude=<long>&latitude=<lat>	Ex: 05100	Connecté avec api-adresse-data pour les adresses françaises + api wemap pour les adresses étrangères (https://api.getwemap.com/v3.0/geocoding/geocode)
Commune	Nom de la commune du lieu	t_place	city	Chaîne de caractères	255	O	Exemple de requête : /v3.0/geocoding/geocode?longitude=<long>&latitude=<lat>	Ex: Briançon	Connecté avec api-adresse-data pour les adresses françaises + api wemap pour les adresses étrangères (https://api.getwemap.com/v3.0/geocoding/geocode)
Autres communes	Autres communes rattachées au lieu	t_place	other_cities	Chaîne de caractères	255	F	Sous forme de json. Valeur par défaut tableau vide. Séparateur : virgule Ex : ['Paris', 'Hyères', 'Marseille']	Ex: Lieu-dit
Code Insee	Code Insee du lieu	t_place	insee_code	Chaîne de caractères	255	F		Ex: 05023
Code Insee Arrondissement	Code Insee Arrondissement	t_place	insee_sub	Chaîne de caractères	255	F	valeur du code insee commune	Ex: 051	Connecté avec API Geo.api.gouv : https://geo.api.gouv.fr/decoupage-administratif/communes
Département	Nom du Département du lieu	t_place	department	Chaîne de caractères	255	F	Exemple de requête : https://geo.api.gouv.fr/departements/<departementCode>?fields=nom	Ex: Hautes-Alpes	Connecté avec API Geo.api.gouv : https://geo.api.gouv.fr/decoupage-administratif/communes
Code Insee département	Code Insee du département du lieu	t_place	insee_department	Chaîne de caractères	255	F	Exemple de requête : https://geo.api.gouv.fr/communes?lon=<long>&lat=<lat>&fields=codeDepartement	Ex: 05	Connecté avec API Geo.api.gouv : https://geo.api.gouv.fr/decoupage-administratif/communes
Région	Nom de la Région du lieu	t_place	region	Chaîne de caractères	255	F	Exemple de requête : https://geo.api.gouv.fr/regions/<regionCode>?fields=nom	Ex: Provence-Alpes-Côte d'Azur	Connecté avec API Geo.api.gouv : https://geo.api.gouv.fr/decoupage-administratif/communes
Code Insee Region	Code Insee de la région du lieu	t_place	insee_region	Chaîne de caractères	255	F	Exemple de requête : https://geo.api.gouv.fr/communes?lon=<long>&lat=<lat>&fields=codeRegion	Ex: 93	Connecté avec API Geo.api.gouv : https://geo.api.gouv.fr/decoupage-administratif/communes
Pays	Pays du lieu	t_place	country	Chaîne de caractères	255	O	Exemple de requête : /v3.0/geocoding/geocode?longitude=<long>&latitude=<lat>	Ex: France	Connecté avec api-adresse-data pour les adresses françaises + api wemap pour les adresses étrangères (https://api.getwemap.com/v3.0/geocoding/geocode)
Latitude	Coordonnée géographique de latitude du lieu	t_place	latitude	Nombre décimal	1E-307 jusqu'a 1E+308 avec une precison d'au moins 15 digits	O	Double précision Exemple de requête : /v3.0/geocoding/geocode?address=<adresse>	Ex: 44.899461	Connecté avec API api-adresse.data pour les coordonnées française + API weMap pour les étrangères
Longitude	Coordonnée géographique de longitude du lieu	t_place	longitude	Nombre décimal	1E-307 jusqu'a 1E+308 avec une precison d'au moins 15 digits	O	Double précision Exemple de requête : /v3.0/geocoding/geocode?address=<adresse>	Ex: 6.642914	Connecté avec API api-adresse.data pour les coordonnées française + API weMap pour les étrangères
Point terrestre	Un point servant à faire des recherche par distance par rapport à un lieu	t_place	earth_point	Chaîne de caractères	50	O	Créé automatiquement à partir des coordonées. Utilisation de l'extension postgis, Point avec SRID=4326	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	Format	Longueur	Obligatoire(O)/ Facultatif (F)	Règles de gestions	Exemple
Nom domaine	Liste des domaines du lieu	t_domain	name	Chaîne de caractères	255	O	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	Chaîne de caractères	255	O	Dupliquer par défaut du Nom domaine	Ex : Patrimoine
Nom sous-domaine	Liste des sous-domaines du lieu	t_subdomain	name	Chaîne de caractères	255	O	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	Chaîne de caractères	255	O	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	Chaîne de caractères	255	F	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	Chaîne de caractères	255	O	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	Chaîne de caractères	255	F	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	Chaîne de caractères	255	O	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	Chaîne de caractères	255	F	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	Chaîne de caractères	255	F	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	Chaîne de caractères	4	F	Lié au champ Protections, labels ou appellation	Ex: 1950
Description	Description du lieu par rapport au sous-domaine concerné	t_subdomain_informations	description	Chaîne de caractères	8000	F		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	Chaîne de caractères	255	F	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	Chaîne de caractères	1000	O	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	Boléen		O	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	Chaîne de caractères	1000	F		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	Nombre entier	Max 2147483647	F		Ex: 87
Identifiant DEPS	Identifiant (créé par le DEPS) du lieu de la base métier source	t_subdomain_informations	deps_id	Chaîne de caractères	255	F		Ex: MONH_05023_0015
Identifiant d'origine	Identifiant du lieu de la base d'origine	t_subdomain_informations	origin_id	Chaîne de caractères	255	F		Ex: PA00080535
Source	Identifie le nom de la source de la donnée	t_subdomain_informations	origin_source	Chaîne de caractères	255	F		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	Format	Longueur	Obligatoire(O)/ Facultatif (F)	Règles de gestions	Exemple
Site internet et autres liens	Site internet et réseaux sociaux du lieu	t_place	website	Chaîne de caractères	255	F	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	Chaîne de caractères	255	F	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	Chaîne de caractères	255	F	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	Chaîne de caractères	pas de maximum	F	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	Chaîne de caractères	pas de maximum	F	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	Boléen		F		Ex: Oui
Retrait sur place	Indique si l'utilisateur peut retirer sur place (ex: des livres)	t_place	pick_up_on_site	Boléen		F		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	Boléen		F		Ex: Oui
Condition d'accès	Indique les conditions d'accès au lieu	t_place	access_condition	Chaîne de caractère	500	F	Limité à 500 caractères dans le formulaire de contribution	Ex : Parking gratuit
Superficie / surface	Surface du lieu en m²	t_place	area	Decimal	1E-307 jusqu'a 1E+308 avec une precison d'au moins 15 digits	F		Ex: 2000
Nombre de salles	Indique le nombre de salles existantes dans le lieu concerné	t_place	number_of_room	Nombre entier	Max 2147483647	F		Ex: 10
Catégories d'ERP	Indique le nombre de personnes pouvant etre présent dans le lieu	t_place	number_of_people	Nombre entier	Max 2147483647	F	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	Chaîne de caractère	3	F	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	jsonb		F	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	Nombre entier	Max 2147483647	F		Ex: 5