Données
Renseignements sur les données ouvertes des cartes interactives
Aperçu
Les ensembles de données suivants sont accessibles.
- Travaux de construction
- Événements spéciaux
- Incidents
- Caméras de circulation
- Parcs de stationnement
- Parc-o-bus
- Appareils photo reliés aux feux rouges
Il existe deux façons de recevoir des renseignements au moyen du site de cartes de circulation interactives.
- Listes de données: Aucune inscription nécessaire, accès direct aux ensembles de données.
- Mises à jour en direct: Inscription nécessaire. Les mises à jour se limitent aux travaux de construction, aux événements spéciaux et aux incidents. Lorsque des données sur ces sujets sont ajoutées, modifiées ou retirées des cartes de circulation interactives, un message contenant cette information est envoyé au serveur Web enregistré. Les utilisateurs de ce service doivent fournir une URL à un serveur qui accepte les messages HTTP POST.
Dans les deux cas, les données sont disponibles en format JSON.
1. Inscription
Pour recevoir les mises à jour en direct, remplissez le formulaire suivant :
http://trafficopendata.ottawa.ca/ts/rsadmin/certificate_fr.jsp
Le champ « URL de l'avis d'incident en temps réel » est facultatif.
- Fournissez l'URL d'un serveur qui accepte les messages HTTP POST pour recevoir les mises à jour en direct liées à la construction, aux événements spéciaux et incidents.
- Si vous voulez seulement obtenir un certificat pour accéder aux caméras en direct de la Ville d'Ottawa, n'écrivez rien dans ce champ.
2. Mises à jour en direct
Des objets JSON seront envoyés pour les événements suivants :
Incidents: Il peut s'agir d'un événement imprévu qui a une incidence sur la circulation (p. ex., fermeture d'urgence d'une route, accident).
Travaux de construction ou travaux routiers : prévus qui ont une incidence sur la circulation.
Événements spéciaux : d'autres événements qui ont une incidence sur la circulation (p. ex., défilés, manifestations, activités communautaires).
Dans chaque cas, un message JSON sera envoyé dès quâun objet est créé, modifié ou retiré.
2.1 Format des messages de mise à jour en direct
Les messages JSON à données ouvertes seront composés d'un objet à trois champs :
- ObjectType
- ObjectAction
- ObjectData
ObjectType peut avoir l'une des valeurs suivantes : CONSTRUCTION_EVENT, SPECIAL_EVENT, INCIDENT
ObjectAction peut avoir l'une des valeurs suivantes : CONSTRUCTION_EVENT, SPECIAL_EVENT, INCIDENT
ObjectData contient les données réelles de l'objet soumis. Ce sont les champs tels quâils sont décrits dans la section « Format du contenu du message » ci-dessous.
2.2 Format du contenu du message
Nom |
Type |
Obligatoire |
Description |
Id |
Entier relatif |
Oui |
Code d'identification de l'objet envoyé. Le code est unique pour un type d'objet (p. ex., événements spéciaux), mais pas entre différents types d'objet (p. ex., un événement de construction et un événement spécial pourraient avoir le même code). |
description |
Chaîne |
Oui |
Courte description ou titre de l'incident, des travaux de construction ou de l'événement spécial, comprenant généralement les rues touchées. |
descriptionFrench |
Chaîne |
Non |
Description en français. |
message |
Chaîne |
Oui |
Renseignements plus détaillés. |
messageFrench |
Chaîne |
Oui |
Message en français. |
latitude |
Double |
Oui |
Latitude du lieu de l'événement. |
longitude |
Double |
Oui |
Longitude du lieu de l'événement. |
twitterMessage |
Chaîne |
Non |
Version du message qui convient à la publication sur Twitter (c.-à -d., au maximum 140 caractères). |
twitterMessageFrench |
Chaîne |
Non |
Version du message qui convient à la publication sur Twitter (c.-à -d., au maximum 140 caractères). |
displayStartDate |
Entier relatif (millisecondes depuis le 1er janvier 1970, 00:00:00 UTC) |
Non (absent pour les incidents) |
(Prévoir incidents) Date de publication du message. Une valeur nulle indique que le message doit être publié immédiatement, alors que les autres valeurs indiquent quand il doit être publié. Remarque : Les messages JSON ne seront pas envoyés avant la date de publication. |
displayEndDate |
Entier relatif (millisecondes depuis le 1er janvier 1970, 00:00:00 UTC) |
Non (absent pour les incidents) |
(Prévoir incidents) Date de retrait ou d'échéance du message. Une valeur nulle indique que le message doit être affiché jusquâà ce quâil soit effacé, alors que les autres valeurs indiquent jusquâà quand il doit être affiché. Remarque : Les objets peuvent être modifiés, ce qui peut avoir une incidence sur la date de retrait du message. Remarque : Le retrait de l'objet a préséance sur la date de retrait du message indiquée. |
2.3 Exemples de messages
{"ObjectType": "CONSTRUCTION_EVENT", "ObjectAction": "NEW", "ObjectData": {"enabled":true,"displayStartDate":null,"displayEndDate":null,"descriptionFrench":"Innes à Cyrville","twitterMessage":"Innes E/B lane reduction at Cyrville - construction.","twitterMessageFrench":"Innes d/e réduction de voies à Cyrville - construction.","message":"Innes eastbound lane reduction at Cyrville due to construction.","messageFrench":"Innes direction est réduction de voies à Cyrville en raison de construction.","id":9,"latitude":45.76,"longitude":-75.98,"description":"Innes at Cyrville"}}
{"ObjectType": "CONSTRUCTION_EVENT", "ObjectAction": "UPDATE", "ObjectData": {"enabled":true,"displayStartDate":1380600000000,"displayEndDate":1381377600000,"descriptionFrench":"Innes à Cyrville","twitterMessage":"Innes E/B lane reduction at Cyrville - construction.","twitterMessageFrench":"Innes d/e réduction de voies à Cyrville - construction.","message":"Innes eastbound lane reduction at Cyrville due to construction.","messageFrench":"Innes direction est réduction de voies à Cyrville en raison de construction.","id":9,"latitude":45.76,"longitude":-75.98,"description":"Innes at Cyrville"}}
{"ObjectType": "CONSTRUCTION_EVENT", "ObjectAction": "DELETE", "ObjectData": {"enabled":true,"displayStartDate":1380600000000,"displayEndDate":1381464000000,"descriptionFrench":"Innes à Cyrville","twitterMessage":"Innes E/B lane reduction at Cyrville - construction.","twitterMessageFrench":"Innes d/e réduction de voies à Cyrville - construction.","message":"Innes eastbound lane reduction at Cyrville due to construction.","messageFrench":"Innes direction est réduction de voies à Cyrville en raison de construction.","id":9,"latitude":45.76,"longitude":-75.98,"description":"Innes at Cyrville"}}
{"ObjectType":
"INCIDENT", "ObjectAction": "NEW",
"ObjectData": {"enabled":true,
,"descriptionFrench":"Bank à
{"ObjectType":
"SPECIAL_EVENT", "ObjectAction": "DELETE",
"ObjectData": {"enabled":true,"displayStartDate":1380600000000,"displayEndDate":null,"descriptionFrench":"Bank
à Wellington","twitterMessage":"Bank closed at Wellington -
protest. Duration 2 hrs.
","twitterMessageFrench":"Bank fermé à
2.4 Remarques et utilisation
Les messages JSON sont considérés comme reçus par le client. Le système ne vérifie pas si le message a bel et bien été reçu et ne le renverra pas. Dans cette optique, sachez que :
- si vous recevez un message de MISE À JOUR pour un objet sans avoir d'abord reçu un message d'AJOUT, vous devez traiter le message de MISE À JOUR en tant que nouvel objet;
- si vous recevez un message de RETRAIT pour un objet sans avoir d'abord reçu un message d'AJOUT, vous pouvez ignorer le message de RETRAIT;
- pour vous assurer de ne manquer aucun message, vous pouvez vérifier régulièrement les URL ci-dessous pour voir la liste de tous les événements actuellement affichés sur le site Web.
http://traffic.ottawa.ca/map/construction_list
http://traffic.ottawa.ca/map/special_event_list
http://traffic.ottawa.ca/map/incident_list
Si vous ne recevez pas les messages correctement, vérifiez que les bonnes URL ont été envoyées sur le site de données ouvertes. La Ville d'Ottawa se réserve le droit de vérifier si certains clients ont des problèmes d'envoi persistants et de les retirer si tel est le cas.
3. Listes de données
Les ensembles de données suivants sont directement accessibles à partir des liens ci-dessous. Les données sont renvoyées sous forme d'ensemble d'objets JSON.
Ensemble de données |
URL des messages JSON |
Champs |
Parcs de stationnement |
id, description, message, messageFrench, latitude, longitude |
|
Parc-o-bus |
id, description, message, messageFrench, latitude, longitude |
|
Appareils photo reliés aux feux rouges |
id, description, message, messageFrench, latitude, longitude |
|
Caméras de circulation |
id, description, descriptionFr, number, enabled, operatorEnabled, latitude, longitude |
|
Incidents |
id, description, descriptionFrench, message, messageFrench, displayStartDate, displayEndDate, latitude, longitude, |
|
Événements spéciaux |
id, description, descriptionFrench, message, messageFrench, displayStartDate, displayEndDate, latitude, longitude, twitterMessage, twitterMessageFrench |
|
Construction |
id, description, descriptionFrench, message, messageFrench, displayStartDate, displayEndDate, latitude,longitude, twitterMessage, twitterMessageFrench |
3.1 Champs
Voici une description des champs que vous verrez sur les listes d'objets JSON. Consultez le répertoire des listes de données pour voir les types de données qui correspondent à chaque champ.
Nom |
Type |
Description |
id |
Entier relatif |
The ID of the object sent. The ID is unique to an object type (e.g. Special Events), but not across (e.g. a construction event and a special event could have the same ID).Code d'identification de l'objet envoyé. Le code est unique pour un type d'objet (p. ex., événements spéciaux), mais pas entre différents types d'objet (p. ex., un événement de construction et un événement spécial pourraient avoir le même code). |
description |
Chaîne |
Courte description ou titre de l'incident, des travaux de construction ou de l'événement spécial, comprenant généralement les rues touchées. |
descriptionFrench |
Chaîne |
Description en français. |
descriptionFr |
Chaîne |
Description en français. |
message |
Chaîne |
Renseignements plus détaillés. |
messageFrench |
Chaîne |
Message, mais en français. |
latitude |
Double |
Latitude du lieu de l'événement. |
longitude |
Double |
Longitude du lieu de l'événement. |
twitterMessage |
Chaîne |
Version du message qui convient à la publication sur Twitter (c.-à -d., au maximum 140 caractères). |
twitterMessageFrench |
Chaîne |
Message Twitter en français. |
type |
Chaîne |
Utilisé pour distinguer les caméras de circulation de la Ville et celles du ministère des Transports de l'Ontario (MTO). Les valeurs peuvent être « CITY » ou « MTO ». |
number |
Entier relatif |
Numéro de caméra unique |
displayStartDate |
Entier relatif (millisecondes depuis le 1er janvier 1970, 00:00:00 UTC) |
Date de publication du message. Une valeur nulle indique que le message doit être publié immédiatement, alors que les autres valeurs indiquent quand il doit être publié. Remarque : Les messages JSON ne seront pas envoyés avant la date de publication. |
displayEndDate |
Entier relatif (millisecondes depuis le 1er janvier 1970, 00:00:00 UTC) |
Date de retrait ou d'échéance du message. Une valeur nulle indique que le message doit être affiché jusquâà ce quâil soit effacé, alors que les autres valeurs indiquent jusquâà quand il doit être affiché. Remarque :: Les objets peuvent être modifiés, ce qui peut avoir une incidence sur la date de retrait du message Remarque :Le retrait de l'objet a préséance sur la date de retrait du message indiquée. |
3.2. Exemples de données
Incidents:
[{"descriptionFrench":"Sussex - Bruyere à Boteler","twitterMessage":"","twitterMessageFrench":"","message":"Sussex lane reductions from Bruyere to Boteler due to construction. Duration is unknown. Expect delays.","messageFrench":"Sussex réductions de voies de Bruyere à Boteler en raison de construction. Durée est inconnue. Prévoir retards.","id":13,"latitude":45.432265,"longitude":-75.699148,"description":"Sussex - Bruyere to Boteler"}]
Parcs de stationnement
[{"message":"Total Capacity: 52","messageFrench":"Capacité totale: 52","id":25,"latitude":45.417527,"longitude":-75.699194,"description":"212 Gloucester"},{"message":"Total Capacity: 293","messageFrench":"Capacité totale: 293","id":26,"latitude":45.428813,"longitude":-75.693457,"description":"70 Clarence"},{"message":"Total Capacity: 453","messageFrench":"Capacité totale: 453","id":27,"latitude":45.429892,"longitude":-75.69133,"description":"141 Clarence "}]