Aller au contenu principal

Structure d'un lieu

Un lieu est un point de rencontre physique: un bâtiment, un lieu-dit, un espace ouvert... Voici la liste complète des champs définissant un lieu.

ChampCodeÉditableRequisDescription
IdentifiantuidIdentifiant unique du lieu (non éditable)
Nom du lieu ⁽ʳ⁾name✅✅Texte (max. 100 caractères). Exemple : Musée de la Folie Marco
Identifiants externesextIds✅Liste de clés/paires identifiant le lieu sur des jeux de données externes à OpenAgenda. Voir ci-dessous pour des détails.
Adresse ⁽ʳ⁾address✅✅Texte (max. 255 caractères)
Accèsaccess✅Texte multilingue (max. 1000 caractères). Instructions d’accès (ex. { fr: "Métro 3, Pont de Levallois" })
Descriptiondescription✅Texte multilingue (max. 5000 caractères). Présentation du lieu (voir l’exemple pour Château de Villeneuve La Comtesse)
Imageimage✅URL ou objet d’illustration du lieu
Crédits imageimageCredits✅Crédits liés à l’illustration
SlugslugIdentifiant textuel non éditable
Jeu de lieusetUidIdentifiant du jeu de lieux associé (non éditable)
RégionadminLevel1✅Région (pour lieux en France)
DépartementadminLevel2✅Département (pour lieux en France)
IntercommunalitéadminLevel3✅Intercommunalité
VilleadminLevel4✅Ville ou commune
ArrondissementadminLevel5✅Pour les grandes villes
QuartieradminLevel6✅Quartier
Code postalpostalCode✅Code postal
Code INSEEinsee✅Code INSEE de la commune
Pays ⁽ʳ⁾countryCode✅✅Code pays ISO 3166‑1 alpha 2 (ex. CH)
Latitudelatitude✅Coordonnée géographique décimale (ex. 48.4102778)
Longitudelongitude✅Coordonnée géographique décimale (ex. 7.4511111)
Fuseau horairetimezone✅Exemple : Europe/Paris
Site webwebsite✅URL principale
Emailemail✅Adresse email de contact principale
Téléphonephone✅Numéro de téléphone de contact principal
Autres lienslinks✅Liste de liens hypertextes (ex. réseaux sociaux, site extérieur)
Statutstate✅Statut du lieu : 0 (à vérifier) ou 1 (vérifié)
Date créationcreatedAtDate de création (non éditable)
Date mise à jourupdatedAtDate de dernière mise à jour (non éditable)
Identifiant externeextIdDéprequé: référence au lieu un jeu de données externe à OpenAgenda

(g) généré automatiquement par géocodage si non fourni

Identifiants externes​

Il est possible d'associer à un lieu référencé sur OpenAgenda des identifiants autres que son identifiant unique (UID). Ce dernier est toujours défini et ne peut être édité.

Les identifiants externes pour lier le lieux à des référentiels exterieurs à OpenAgenda. Par exemple, la donnée suivante montre un lieu qui porte une référence à la base deslieux culturels du ministère de la Culture ainsi qu'une autre d'un répertoire de la métropole de Nantes

{
...
"extIds": [{
"key": "MCCBLCID",
"value": "62adc12a-3316-5d66-9e6f-ca989ada7a13?dc93fb2a-806a-45dc-90ed-b72324c12e69"
}, {
"key": "InfoNantes",
"value": "7894"
}],
...
}