Premier pas avec Opendatasoft
Explorer et utiliser les données
Explorer le catalogue et les jeux de données
Explorer un catalogue de jeux de données
Contenu d'un jeu de données
Filtrer des données dans un jeu de données
Introduction à l'API Explore
Introduction à l'API Automation
Présentation de l'API WFS
Télécharger un jeu de données
Créer des cartes et des graphiques
Création de graphiques avancés avec l'outil Graphiques
Présentation de l'interface Cartes
Configurez votre carte
Gérez vos cartes
Réorganiser et regrouper les couches dans une carte
Création de cartes multicouches
Partagez votre carte
Navigation dans les cartes créées avec le créateur de Cartes
Renommer et enregistrer une carte
Créer des pages avec l'éditeur de code
Archivage d'une page
Gérer la sécurité d'une page
Créer une page avec l'éditeur de code
Pages de contenu : idées, conseils et ressources
Comment insérer des liens internes sur une page ou créer une table des matières
Partager et intégrer une page de contenu
Comment dépanner les cartes qui ne se chargent pas correctement
Créer des pages avec le Studio
Créer du contenu avec Studio
Ajouter une page
Publier une page
Modifier la mise en page
Configurer des blocs
Aperçu d'une page
Ajouter du texte
Ajout d'un graphique
Ajouter un bloc image à une page Studio
Ajouter un bloc de carte choroplèthe dans Studio
Ajout d'un bloc de carte de points d'intérêt dans Studio
Ajouter un indicateur clé de performance (KPI)
Configurer les informations d'une page
Utiliser des filtres pour améliorer vos pages
Affiner les données
Gérer l'accès aux pages
Comment modifier l'url d'une page Studio
Ajouter un bloc de carte dans Studio
Les visualisations
Gérer les visualisations sauvegardées
Configurer la visualisation Calendrier
Explorer les différentes visualisations d'un jeu de données
Configurer la visualisation Images
Configurer la vue personnalisée
Configurer la visualisation Tableau
Configurer la visualisation Carte
Comprendre le regroupement automatique dans les cartes
Configurer la visualisation Analyse
Publier des données
Publier vos jeux de données
Créer un jeu de données
Créer un jeu de données à partir d'un fichier local
Créer un jeu de données avec plusieurs fichiers
Création d'un jeu de données à l'aide de connecteurs dédiés à des services distants spécifiques
Créer un jeu de données avec des fichiers multimédias
Fédérer un jeu de données Opendatasoft
Publier un jeu de données
Formats de fichiers pris en charge
Valorisez les données de mobilité grâce au GTFS et autres formats
Gérer les configurations de vos jeux de données
Suppression automatique des enregistrements
Configuration de l'export de jeux de données
Consulter l'historique du jeu de données
Configurer l'info-bulle
Actions et états des jeux de données
Limites des jeux de données
Définir un modèle de données
Comment Opendatasoft gère les dates
Comment et où Opendatasoft gère les fuseaux horaires
Comment trouver l'adresse IP de votre espace de travail
Maintenir les données à jour
Traiter des données
Traduire un jeu de données
Comment configurer une connexion HTTP à l'API de France Travail
Décider quelle licence convient le mieux à votre jeu de données
Formats de fichier source
Fichiers OpenStreetMap
Shapefiles
Fichiers JSON
Fichiers XML
Fichiers de feuille de calcul
Fichiers RDF
Fichiers CSV
Fichiers MapInfo
Fichiers GeoJSON
Fichiers KML
GeoPackage
Les connecteurs
Sauvegarde et partage de connexions
Connecteur Airtable
Connecteur Amazon S3
Connecteur ArcGIS
Connecteur de stockage Azure Blob
Connecteur de base de données
Connecteur Jeu de données de jeux de données (espace de travail)
Connecteur Eco Counter
Connecteur Feed
Connecteur Google BigQuery
Connecteur Google Drive
Comment trouver la clé API Open Agenda et l'URL Open Agenda
Connecteur JCDecaux
Connecteur Netatmo
Connecteur OpenAgenda
Connecteur Realtime
Connecteur Salesforce
Connecteur SharePoint
Connecteur US Census
Connecteur WFS
Connecteur Databricks
Les moissonneurs
Moissonner un catalogue
Moissonneur ArcGIS
Moissonneur ArcGis Hub Portals
Moissonneur CKAN
Moissonneur CSW
Moissonneur FTP avec CSV de métadonnées
Moissonneur Fédération Opendatasoft
Moissonneur Quandl
Moissonneur Socrata
Moissonneur data.gouv.fr
Moissonneur data.json
Les processeurs
Qu'est-ce qu'un processeur et comment l'utiliser ?
Processeur Ajouter un Champ
Processeur Calculer la distance géographique
Processeur Concaténer du texte
Processeur Convertir des degrés
Processeur Copier un Champ
Processeur Corriger les formes géographiques
Processeur Créer un point géo
Processeur Décoder les entités HTML
Processeur Décoder un polyline Google
Processeur Dédupliquer des champs multivalués
Processeur Supprimer un enregistrement
Processeur Déplier le tableau JSON
Processeur Déplier les champs à valeur multiples
Processeur Expression
Processeur Extraire du HTML
Processeur Extraire les URLs
Processeur Extraire la plage de bits
Processeur Extraire d'un objet JSON
Processeur Extraire du texte
Processeur Fichier
Processeur GeoHash en GeoJSON
Processeur de jointure géographique
Processeur Géocoder avec ArcGIS
Processeur Géocoder avec la BAN (France)
Processeur Géocoder avec PDOK
Processeur Géocoder avec le Census Bureau (États-Unis)
Processeur Masquage géographique
Processeur Récupérer les coordonnées d'une adresse 3 mots
Processeur Adresse IP vers Coordonnées Géo
Processeur Tableau JSON vers multivalué
Processeur Joindre des jeux de données
Processeur Méta-expression
Processeur Géocodeur Nominatim
Processeur Normaliser le Système de Projection
Processeur Normaliser une URL
Processeur Normaliser les valeurs Unicode
Processeur Normaliser une date
Processeur Filtrage du polygone
Processeur Remplacer le texte
Processeur Remplacer avec une expression régulière
Processeur Récupérer les divisions administratives
Processeur Définir le fuseau horaire
Processeur Simplifier les formes géo
Processeur Ignorer les enregistrements
Processeur Séparer le texte
Processeur Transformer des colonnes de booléens en champs multivalués
Processeur Transposer des colonnes en lignes
Processeur WKT et WKB en GeoJSON
Processeur what3words
La fonctionalité Formulaire de Collecte de Données
À propos de la fonctionnalité Formulaire de Collecte de Données
Formulaires de collecte de données associé à votre espace de travail Opendatasoft
Créez et gérez vos formulaires de collecte de données
Partager et modérer vos formulaires de collecte de données
Metadonnées des ensembles de données
Analyser l'utilisation de mes données
S'impliquer : partager, réutiliser et réagir
Découvrir et soumettre des réutilisations de données
Partage via les réseaux sociaux
Commenter via Disqus
Suivre les mises à jour d'un jeu de données
Partager et intégrer des visualisations de données
Statistiques d'utilisation
Introduction à l'utilisation des statistiques de vos espaces de travail
Analyser l'activité des utilisateurs
Analyser les actions
Détails sur les champs spécifiques du jeu de données ods-api-monitoring
Comment compter les téléchargements d'un jeu de données sur une période spécifique
Analyser l'utilisation des données
Analyser l'utilisation des ensembles de données
Analyser l'activité du back office
Utilisation de la fonctionnalité de lignage des données
Gérer les groupes et utilisateurs
Gérer les limites
Gérer les utilisateurs
Gestion des utilisateurs
Définition de quotas pour des utilisateurs individuels
Gérer les demandes d'accès
Inviter des utilisateurs sur le portail
Gérer les espaces de travail
Gérer mon portail
Configurer mon portail
Configurer les pages du catalogue et du jeu de données
Configuration d'un catalogue partagé
Partager, réutiliser, communiquer
Personnaliser l'URL de votre espace de travail
Gestion des informations juridiques
Connecter Google Analytics (GA4)
Paramètres régionaux
Gérer le suivi
Navigabilité et apparence
Personnaliser votre portail
Personnaliser les thèmes du portail
Comment personnaliser mon portail selon la langue courante
Gérer les thèmes du jeu de données
Configurer les visualisations de données
Configurer la navigation
Ajouter des ressources
License et quotas
Monitoring de la licence et des quotas de votre espace de travail
Licences et quotas de votre espace de travail
Gérer la sécurité
Configurer la politique de sécurité générale de votre portail
L'onglet Sécurité d'un jeu de données
Mapping de vos groupes Opendatasoft avec votre annuaire (via SSO)
Authentification unique (SSO) avec OpenID Connect
Authentification unique (SSO) avec SAML
Paramètres
Langues prises en charge par Opendatasoft
Configuration des paramètres du compte
Gestion des identités
Comprendre les notifications reçues avec vos autorisations
Gestion des notifications
Gestion des clés API
Accessibilité chez Opendatasoft
Enregistrement des applications
Vérification du quota du compte
- Home
- Publier des données
- Formats de fichier source
- Fichiers JSON
Fichiers JSON
Mis à jour le par Anthony Pépin
JSON est un format standard ouvert qui utilise du texte lisible par l'homme pour transmettre des objets de données constitués de paires clé-valeur. C'est le format de données le plus courant pour créer des API Web.
Comme les documents JSON peuvent avoir de nombreuses formes différentes, la plate-forme peut extraire des données à partir de fichiers JSON, de fichiers Lignes JSON et de dictionnaires JSON.
Fichier JSON
Vous pouvez utiliser un fichier JSON comme source. A partir de ce fichier, la plateforme extrait un document JSON valide (tableau ou objet) en un jeu de données de plusieurs enregistrements :
- Si le document est un tableau JSON, un enregistrement sera créé pour chaque objet à l'intérieur du tableau (les clés seront utilisées comme noms de colonne).
- Si le document est un objet JSON, le paramètre "Racine JSON" doit contenir un chemin séparé par des points vers le tableau à l'intérieur de votre objet. S'il n'est pas fourni, la plate-forme essaie
items
.
Pour chaque élément à l'intérieur du tableau, la plateforme peut suivre un autre chemin avant d'extraire les enregistrements avec le paramètre "objet JSON".
Types de champs pris en charge
- Champs normaux (décimal, booléen, chaîne)
- Objet JSON : utilisé tel quel
- Tableau:
- Si le tableau contient des objets JSON, il est utilisé tel quel.
- Si le tableau contient des chaînes, un champ à plusieurs valeurs est créé avec toutes les chaînes séparées par un point-virgule (
;
).
Création
Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier.
Configuration
Nom | Description | Utilisation |
Racine JSON | Le chemin d'accès ijson au tableau JSON qui contient les objets à extraire en tant qu'enregistrements de jeu de données ijson est une syntaxe permettant de naviguer dans les objets JSON. Elle consiste à séparer les noms d’attribut avec des points (par exemple, ). Des fonctionnalités supplémentaires sont disponibles pour les utilisateurs avancés. | Si le tableau JSON se trouve à la racine du document, laissez la zone racine JSON vide. Si le fichier JSON est un objet JSON, entrez le chemin ijson vers le tableau dans la zone racine JSON . |
Objet JSON | Chemin relatif vers l'objet JSON à extraire | Après avoir défini la racine JSON, si l'aperçu affiche des colonnes non pertinentes et que l'objet JSON a été extrait en tant que valeur d'une colonne, entrez le nom de cette colonne dans la zone Objet JSON . |
Nom | Description | Utilisation |
Extraire le nom du fichier | Crée une nouvelle colonne avec le nom du fichier source. | Par défaut, cette option est désactivée. Activez cette option pour extraire le nom du fichier dans une colonne supplémentaire. |
Exemples
Exemple 1:
[
{
"name": "Agra Express",
"origin": "Agra Cantt",
"destination": "New Delhi"
},
{
"name": "Gour Express",
"origin": "Balurghat",
"destination": "Sealdah"
}
]
Dans ce fichier JSON, le tableau JSON est directement à la racine. Vous pouvez laisser la zone racine JSON vide.
Le jeu de données résultant sera :
Nom | origine | destination |
Agra express | Agra Cantt | New Delhi |
Gour Express | Balurghat | Sealdah |
Exemple 2 :
{
"filename": "trains.json",
"content": {
"trains": [
{
"id": 123,
"info": {
"name": "Agra Express",
"origin": "Agra Cantt",
"destination": "New Delhi"
}
},
{
"id": 555,
"info": {
"name": "Gour Express",
"origin": "Balurghat",
"destination": "Sealdah"
}
}
]
}
}
Pour ce fichier JSON complexe, la racine JSON correcte est content.trains
. Si content.trains
est défini comme racine JSON, le jeu de données résultant sera :
Id | Info |
123 | {"origin": "Agra Cantt", "destination": "New Delhi", "name": "Agra Express"} |
555 | {"origin": "Balurghat", "destination": "Sealdah", "name": "Gour Express"} |
Pour extraire uniquement les objets JSON info
et ignorer le numéro d' id
, l'objet JSON correct est info
. Si info
st défini en tant qu'objet JSON, le jeu de données résultant sera :
Nom | origine | destination |
Agra express | Agra Cantt | New Delhi |
Gour Express | Balurghat | Sealdah |
Lignes JSON
Vous pouvez utiliser un fichier Lignes JSON comme source. Dans les fichiers Lignes JSON, chaque ligne est un document JSON d'une ligne. L'ensemble du fichier n'est pas un document JSON valide, mais chaque ligne l'est.
Deux modes sont pris en charge :
- Un tableau JSON sur chaque ligne (ou un tableau globa)
- Un objet JSON sur chaque ligne
Types de champs pris en charge
- Champs normaux (décimal, chaîne de caractères)
- Tableau : utilisé tel quel
- Objet JSON : utilisé tel quel
Création
Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier .
Configuration
Nom | La description | Usage |
Extraire le nom de fichier | Crée une nouvelle colonne avec le nom du fichier source. | Par défaut, cette option est désactivée. Activez cette option pour extraire le nom du fichier dans une colonne supplémentaire. |
Numéro de la première ligne | Pour les fichiers qui ne commencent pas à la première ligne, il est possible de définir quelle ligne est considérée comme la première. Les lignes précédentes seront ignorées du jeu de données. | Par défaut, le jeu de données commence à la ligne 1. Entrez le numéro de la ligne qui doit être considérée comme le début du jeu de données. |
En-têtes | Pour les fichiers dont la première ligne contient des noms de champs | Par défaut, cette option est activée. Les valeurs de la première ligne deviennent des labels de champs. Désactivez cette option si la première ligne ne contient pas de noms de champs mais des données : les labels de champs seront vides par défaut. |
JSON Dict
Vous pouvez utiliser un dictionnaire JSON comme source. La plateforme extrait un document JSON valide (tableau ou objet) dans un jeu de données de plusieurs enregistrements.
La plateforme attend un objet JSON où chaque clé contient un enregistrement. La plateforme crée alors des enregistrements avec :
- une colonne pour contenir la clé
- une colonne pour chaque attribut de l'objet correspondant (ou une colonne unique nommée "value" si la valeur est une chaîne de caractères au lieu d'un objet).
Types de champs pris en charge
- Champs normaux (décimal, booléen, chaîne de caractères)
- Objet JSON : sera utilisé tel quel
- Tableau:
- Si le tableau contient des objets JSON, il est utilisé tel quel.
- Si le tableau contient des chaînes de caractères, un champ à plusieurs valeurs est créé avec toutes les chaînes séparées par un point-virgule (
;
).
Création
Pour plus d'informations sur l'ajout d'une source de fichier, voir Récupération d'un fichier .
Configuration
Nom | Description | Utilisation |
Extraire le nom du fichier | Crée une nouvelle colonne avec le nom du fichier source. | Par défaut, cette option est désactivée. Activez cette option pour extraire le nom du fichier dans une colonne supplémentaire. |
Racine JSON | Le chemin d'accès ijson au tableau JSON qui contient les objets à extraire en tant qu'enregistrements de jeu de données ijson est une syntaxe permettant de naviguer dans les objets JSON. Elle consiste à séparer les noms d’attribut avec des points (par exemple, ). Des fonctionnalités supplémentaires sont disponibles pour les utilisateurs avancés. | Si le tableau JSON se trouve à la racine du document, laissez le champ Racine JSON vide. Si le fichier JSON est un objet JSON, indiquez le chemin d'accès ijson au tableau dans le champ Racine JSON. |
Nom du champ de la clé | Label de la colonne "key". | La valeur par défaut est "key". Saisissez le nouveau label de la colonne "key" dans la case Nom du champ de la clé. Le label et l’identifiant technique de la colonne seront modifiés. |
Exemples
Exemple 1:
{
"2016": {
"type1": {
"price": 10,
"color": "blue",
"available": true
},
"type2": {
"price": 9,
"color": "red",
"available": true
}
},
"2015": {
"type1": {
"price": 10.5,
"color": "teal",
"available": true
},
"type2": {
"price": 9.1,
"color": "crimson",
"available": true
}
}
}
Si vous laissez la zone racine JSON vide, le jeu de données résultant sera :
clé | type 1 | type 2 |
2016 | {"color": "bleu", "disponible": vrai, "prix": 10} | {"color": "rouge", "disponible": vrai, "prix": 9} |
2015 | {"color": "bleu sarcelle", "disponible": vrai, "prix": 10.5} | {"color": "cramoisi", "disponible": vrai, "prix": 9.1} |
Exemple 2 :
{
"results": {
"datasets": [{
"abc": {
"title": "AB C",
"description": "A description about ABC"
}
},
{
"xyz": {
"title": "DE F",
"description": "Another description"
}
}
]
}
}
Pour ce fichier JSON complexe, la racine JSON correcte est results.datasets.item
.
results.datasets
mène au tableauitem
itère à l'intérieur du tableau et récupère chaque objet
Key | Description | Titre |
abc | Une description de l'ABC | abc |
xyz | Un autre descriptif | DÉF |