# DataSource
L'objet DataSource est utilisé pour spécifier une source de données de trains, de vols ou de bus. Ce qu'une source de données charge est déterminé par les propriétés d'URL qu'elle porte. Les sources de données peuvent être définies sous forme de tableau dans l'option du constructeur Map dataSources, ou ajoutées et supprimées à l'exécution avec Map#addDataSource et Map#removeDataSource.
Avertissement
Notez qu'il s'agit d'une fonctionnalité expérimentale en cours de développement et susceptible de changer.
Pour les données de trains (trainUrl et trainInfoUrl), le format de chaque objet est détecté automatiquement à partir de son @type : les objets dont le @type est 'odpt:Train' ou 'odpt:TrainInformation' sont analysés au format brut ODPT (opens new window), sinon au format Mini Tokyo 3D pré-normalisé. Lorsque plusieurs sources de données contiennent le même train, vol ou information sur les trains, les sources qui apparaissent plus tard dans le tableau remplacent les précédentes.
Pour une URL dont l'hôte est enregistré comme hôte compatible ODPT, le jeton d'accès correspondant dans Secrets est automatiquement ajouté comme clé de consommateur.
Type Object (opens new window)
# Propriétés
# atisUrl (string (opens new window))
L'URL des données d'information sur le trafic aéroportuaire (ATIS), utilisées avec flightUrl pour déterminer l'exploitation des pistes. En cas d'omission, aucune donnée ATIS n'est chargée à partir de cette source de données.
# color (string (opens new window))
Pour une source de données GTFS (avec gtfsUrl), une couleur utilisée pour afficher les itinéraires et les véhicules. Elle est spécifiée par un code couleur hexadécimal commençant par #.
# expiresAt (string (opens new window))
Une chaîne de date-heure ISO 8601 (opens new window). Une fois que l'heure actuelle atteint cette valeur, la source de données n'est plus chargée. En cas d'omission, la source de données n'expire jamais.
# flightUrl (string (opens new window))
L'URL des données de vols. En cas d'omission, aucun vol n'est chargé à partir de cette source de données.
# gtfsUrl (string (opens new window))
L'URL d'un fichier zip de jeu de données GTFS (opens new window). Un ensemble de données GTFS doit contenir au moins les fichiers suivants.
- agency.txt
- stops.txt
- routes.txt
- trips.txt
- stop_times.txt
- calendar.txt ou calendar_dates.txt
- shapes.txt
# id (string (opens new window))
Un ID unique de la source de données. Il est utilisé comme clé pour Map#addDataSource et Map#removeDataSource.
# trainInfoUrl (string (opens new window))
L'URL des données d'information sur les trains. Pour le format brut ODPT, il s'agit d'une URL de requête ODPT odpt:TrainInformation (opens new window) entièrement développée. En cas d'omission, aucune information sur les trains n'est chargée à partir de cette source de données.
# trainUrl (string (opens new window))
L'URL des données de position des trains. Pour le format brut ODPT, il s'agit d'une URL de requête ODPT odpt:Train (opens new window) entièrement développée. En cas d'omission, aucune position de train n'est chargée à partir de cette source de données.
# vehiclePositionUrl (string (opens new window))
Pour une source de données GTFS (avec gtfsUrl), l'URL d'un flux VehiclePosition GTFS Realtime (opens new window). En cas d'omission, les véhicules circuleront selon les horaires.