schema-comptage-mobilites-channel

Comptage des mobilités (Channel)

Spécification du fichier d'échange relatif aux comptages des mobilités.

  • Schéma créé le : 05/06/21
  • Site web : https://github.com/etalab/schema-comptage-mobilites-channel
  • Version : 0.1.0
  • Clé primaire : channel_id

Modèle de données

Liste des propriétés
Propriété Type Obligatoire
channel_id chaîne de caractères Oui
channel_provider_id chaîne de caractères Non
site_provider_id chaîne de caractères Non
site_id chaîne de caractères Oui
mobility_type chaîne de caractères Non
comment chaîne de caractères Non
counter_transmission_type chaîne de caractères Non
publication_transmission_type chaîne de caractères Non
counter_type chaîne de caractères Non
direction chaîne de caractères Non
provider_direction_code chaîne de caractères Non
provider_direction_name chaîne de caractères Non
data_provider_name chaîne de caractères Non
temporality chaîne de caractères Non
started_at date et heure Non
ended_at date et heure Non
last_updated_at date et heure Non
time_step nombre réel Non
provider_portal_url chaîne de caractères Non

Propriété channel_id

Description : Identifiant unique du channel dans le référentiel de la collectivité. Cette valeur doit être utilisée dans le champ channel_id du fichier measure pour faire le lien. Cette valeur doit être unique dans l'ensemble des fichiers.
Ex : C-C-01-Baix

  • Valeur obligatoire
  • Type : chaîne de caractères

Propriété channel_provider_id

Description : identifiant unique du channel dans le référentiel du fournisseur technique. Cette information est utile à des fins de diagnostics/synchronisation de données.
Ex : EC-01-Baix

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété site_provider_id

Description : Identifiant channel dans le réferentiel fournisseur. Cette information ne peut être portée par le site lui même car ça peut être un format multi-fournisseurs.
Ex : MC-Baix

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété site_id

Description : Identifiant unique du site (dans le référentiel de la collectivité) où est installé le compteur dans les bases de données de la collectivité territoriale productrice de données. Cette valeur doit faire référence au champ site_id du fichier site pour faire le lien.
Ex : C01-Baix

  • Valeur obligatoire
  • Type : chaîne de caractères

Propriété mobility_type

Description : Types de pratiques enregistrés par le compteur sur l'infrastructure. Choix multiple possible avec chaque valeur séparée par une virgule (mais dans ce cas il est impératif d'entourer la totalité de la cellule par des guillemets).
Ex : E-SCOOTER,PEDESTRIAN

  • Valeur optionnelle
  • Type : chaîne de caractères
  • Motif : (?:(?:^|,)(BIKE|TWO WHEELS MOTORIZED|PEDESTRIAN|E\-SCOOTER|HORSE\-RIDER|CAR|BUS|MINIBUS|TRUCK|VAN|TRAMWAY|CANOE|UNDEFINED))+$

Propriété comment

Description : Description textuelle de l'usage du channel. Par exemple, peut être utilisé pour indiquer une campagne de relevé temporaire. 50 caractères autorisés.
Ex : Campagne temporaire aout-septembre 2020

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété counter_transmission_type

Description : Méthode utilisée pour récupérer les données depuis le compteur.
Ex : MANUAL

  • Valeur optionnelle
  • Type : chaîne de caractères
  • Valeurs autorisées :
    • REMOTE TRANSMISSION
    • MANUAL

Propriété publication_transmission_type

Description : Méthode utilisée pour transmettre les données vers le portail opendata.
Ex : API

  • Valeur optionnelle
  • Type : chaîne de caractères
  • Valeurs autorisées :
    • API
    • MANUAL

Propriété counter_type

Description : Type de compteur. Choix multiple possible avec chaque valeur séparée par une virgule (mais dans ce cas il est impératif d'entourer la totalité de la cellule par des guillemets). En cas de multiples valeurs, les comptages sont considérés comme étant aggrégées, sans différenciation. Si on souhaite différencier les pratiques, il faut créer plusieurs channels.
Ex : VIDEO SENSOR

  • Valeur optionnelle
  • Type : chaîne de caractères
  • Motif : (?:(?:^|,)(INDUCTIVE LOOP|ELECTROMAGNETIC SENSOR|PASSIVE INFRARED|ACTIVE INFRARED|PIEZOELECTRIC SENSOR|RADAR SENSOR|VIDEO SENSOR|PNEUMATIC TUBE SENSOR|SLAB SENSOR|LIGHT BEAM SENSOR|MANUAL|ACOUSTIC|LIDAR|OPTICAL FIBER SENSOR|MAGNETOMETER|OTHER))+$

Propriété direction

Description : Direction vers laquelle se dirigent les usagers comptés dans le sens 1. Si besoin de modéliser 2 directions, créez deux channels.
Ex : SW

  • Valeur optionnelle
  • Type : chaîne de caractères
  • Valeurs autorisées :
    • N
    • NW
    • NE
    • W
    • SW
    • S
    • SE
    • E

Propriété provider_direction_code

Description : Codification interne aux fournisseurs qui permet d'identifier le sens comme les notions d IN/OUT.
Ex : IN

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété provider_direction_name

Description : Description de la direction qui peut aider un réutilisateur à comprendre le provider_direction_code notamment lorsque le fournisseur ne peut pas, pour l'instant, fournir de champ direction.
Ex : De Gare du Nord vers Gare de l'Est

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété data_provider_name

Description : Entité ayant fourni les données.
Ex : ADAV

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété temporality

Description : Périodicité du comptage. Le compteur compte-t-il temporairement ou de manière permanente sur un même site ?
Ex : PERMANENT

  • Valeur optionnelle
  • Type : chaîne de caractères

Propriété started_at

Description : Date et heure de début de comptage. Utile par exemple pour déclarer un début d'usage de compteur temporaire. Notation ISO 8601, format 1977-04-22T06:00:00Z. Ne doit pas être modifié dans le temps. Si besoin, recréez un nouveau channel).
Ex : 2020-06-22T10:00:00Z

  • Valeur optionnelle
  • Type : date et heure

Propriété ended_at

Description : Date et heure de fin de comptage. Utile par exemple pour déclarer la fin de l'usage d'un compteur. Notation ISO 8601, format 1977-04-22T06:00:00Z. Si ce champ est rempli, un nouveau channel doit être créé.
Ex : 2021-06-22T10:00:00Z

  • Valeur optionnelle
  • Type : date et heure

Propriété last_updated_at

Description : Date de dernière mise à jour des données, Notation ISO 8601, format 1977-04-22T06:00:00Z.
Ex : 2021-06-22T10:00:00Z

  • Valeur optionnelle
  • Type : date et heure

Propriété time_step

Description : Le pas de temps des données fournies, en secondes. Doit être utilisé pour extrapoler la date de fin du comptage si elle est absente. Conditionnellement obligatoire. Obligatoire lorsque le champ end_datetime n'est complété
Ex : 900

  • Valeur optionnelle
  • Type : nombre réel

Propriété provider_portal_url

Description : Page web publique des données.
Ex : http://www.eco-public.com/public2/?id=100057894

  • Valeur optionnelle
  • Type : chaîne de caractères