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 à Wellington","twitterMessage":"Bank closed at Wellington - protest. Duration 2 hrs. ","twitterMessageFrench":"Bank fermé à Wellington - manifestation. Durée 2 hrs. ","message":"Bank closed at Wellington due to a protest. Duration is 2 hours. Avoid area and use other routes if possible.","messageFrench":"Bank fermé à Wellington en raison d\u0027une manifestation. Durée de 2 heures. Éviter secteur et utiliser autres routes si possible.","id":10,"latitude":49.0,"longitude":-75.9,"description":"Bank at Wellington"}}

{"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é à Wellington - manifestation. Durée 2 hrs. ","message":"Bank closed at Wellington due to a protest. Duration is 2 hours. Avoid area and use other routes if possible.","messageFrench":"Bank fermé à Wellington en raison d\u0027une manifestation. Durée de 2 heures. Éviter secteur et utiliser autres routes si possible.","id":10,"latitude":49.0,"longitude":-75.9,"description":"Bank at Wellington"}}

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

http://traffic.ottawa.ca/map/parking_list

id, description, message, messageFrench, latitude, longitude

Parc-o-bus

http://traffic.ottawa.ca/map/park_and_ride_list

id, description, message, messageFrench, latitude, longitude

Appareils photo reliés aux feux rouges

http://traffic.ottawa.ca/map/red_light_camera_list

id, description, message, messageFrench, latitude, longitude

Caméras de circulation

http://traffic.ottawa.ca/map/camera_list

id, description, descriptionFr, number, enabled, operatorEnabled, latitude, longitude

Incidents

http://traffic.ottawa.ca/map/incident_list

id, description, descriptionFrench, message, messageFrench, displayStartDate, displayEndDate, latitude, longitude,

Événements spéciaux

http://traffic.ottawa.ca/map/special_event_list

id, description, descriptionFrench, message, messageFrench, displayStartDate, displayEndDate, latitude, longitude, twitterMessage, twitterMessageFrench

Construction

http://traffic.ottawa.ca/map/construction_list

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 "}]