{"type":"doc","content":[{"type":"paragraph","content":[{"text":"All our products have been","type":"text"},{"text":" updated on ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8b6056a1-7b3a-49ac-ac48-7664e0e5c44d"}}]},{"type":"date","attrs":{"timestamp":"1586476800000"}},{"text":" with the releases associated to the Sprint 39.","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"}},"macroMetadata":{"macroId":{"value":"aac5a66b-1118-4649-af17-403cce537dad"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Chouette","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Last publication time displays now on your public API page","type":"text"}]},{"type":"paragraph","content":[{"text":"Chouette permits to publish your transport data in many formats and in many ways. If you choose an API publication, Chouette publishes automatically for you a public page to help people to consume your API. ","type":"text"}]},{"type":"paragraph","content":[{"text":"On this page, Chouette displays now the last publication time:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":813,"id":"bda29bd3-7311-4299-af75-e6a1377cde9f","collection":"contentId-343212043","type":"file","height":549}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Export Timetables as GTFS Calendars","type":"text"}]},{"type":"paragraph","content":[{"text":"The analysis of the Chouette GTFS exports leads to some improvements on the number of calendars and trips produced.","type":"text"}]},{"type":"paragraph","content":[{"text":"Chouette has now ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6bccd1ca-8acf-4eb5-90fe-97ea895b7fb0"}}]},{"text":"a smarter approach for calendar and trips generation :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each Timetable period, we need to create a Calendar with the associated date range and the day selection. The associated included/excluded dates must create ","type":"text"},{"text":"CalendarDates","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For a Timetable with only included dates, only the ","type":"text"},{"text":"CalendarDates","type":"text","marks":[{"type":"code"}]},{"text":" should be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each Calendar / service_id, the ","type":"text"},{"text":"VehicleJourney","type":"text","marks":[{"type":"code"}]},{"text":" must be exported into a dedicated trip.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Timetable A on week days with two periods and a excluded date (on the first period)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Timetable B with only included dates","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Vehicle Journey 1 which uses the two timetables A & B","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Vehicle Journey 2 which uses only the Timetable B","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"These models should be exported as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Calendar (service_id A1) for the first period of Timetable A and an associated CalendarDate for the excluded date","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Calendar (service_id A2) for the second period of Timetable A","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A CalendarDate for each included dates of Timetable B (with the same service_id B)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Trip for Vehicle Journey 1 associated to the service_id A1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Trip for Vehicle Journey 1 associated to the service_id A2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Trip for Vehicle Journey 1 associated to the service_id B","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Trip for Vehicle Journey 2 associated to the service_id B","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Display object identifier for Stop Area and Line resources","type":"text"}]},{"type":"paragraph","content":[{"text":"Chouette displays now this object identifier with the name “full id” (or “ID complet” in French)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":2526,"id":"35c10ac9-a6d1-464b-bd20-0694f01dc34a","collection":"contentId-343212043","type":"file","height":1241}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"This information is useful for users who want to","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"interpret identifiers used in exports (GTFS, NeTEx, etc)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"prepare API requests in GraphQL","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Search by name or identifier on Line and Stop Area","type":"text"}]},{"type":"paragraph","content":[{"text":"You can now mix filters to use search by name or identifier and every filters for Stop Areas and Lines : postal code, area type, status ...","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1838,"id":"8818e744-b55c-4142-bc98-6859cb5fa424","collection":"contentId-343212043","type":"file","height":907}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Access to exports for Publication ","type":"text"}]},{"type":"paragraph","content":[{"text":"Every publication made by Chouette launches exports in a specific format. You can now consult export details for each publication:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1838,"id":"623a5657-9b28-43ba-8d7c-09cf0b5e67d8","collection":"contentId-343212043","type":"file","height":907}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Manage several ValidBetween in NeTEx IDFM calendar frame","type":"text"}]},{"type":"paragraph","content":[{"text":"When a NeTEx IDFM dataset has a ","type":"text"},{"text":"calendriers.xml","type":"text","marks":[{"type":"code"}]},{"text":" file with several ","type":"text"},{"text":"ValidBetween","type":"text","marks":[{"type":"code"}]},{"text":" tags in the ","type":"text"},{"text":"NETEX_CALENDRIER","type":"text","marks":[{"type":"code"}]},{"text":", the associated Data Set is now created the defined periods.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example of calendriers.xml file:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n 2019-12-12T15:49:25Z\n 32\n \n \n \n 2020-01-02T00:00:00\n 2020-04-11T00:00:00\n \n \n 2020-04-14T00:00:00\n 2020-04-30T00:00:00\n \n \n 2020-05-02T00:00:00\n 2020-05-07T00:00:00\n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prevent consecutive Merges after large IDFM NeTEx import","type":"text"}]},{"type":"paragraph","content":[{"text":"When the ","type":"text"},{"text":"user ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"5392aec2-2c40-47a3-bce1-52a8429486df"}}]},{"text":"launches an Import which creates a large number of Data Sets (this is possible with a large IDFM NeTEx import) with the automatic merge option, Chouette could merge in several operations these imported Data Sets. Chouette starts now only a single Merge when the Import operation is successfully done.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Measure performances with a common Benchmark tool","type":"text"}]},{"type":"paragraph","content":[{"text":"We improve our Benchmark library used in the code to analyse : ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"processing time","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"memory usage","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This updated library checks now every merge and aggregate operation and delivers","type":"text"},{"text":" these data","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"477a8f3f-c954-41fd-97f0-e7e2d16df477"}}]},{"text":" directly to ","type":"text"},{"text":"Datadog","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.datadoghq.com/"}}]},{"text":" (our monitoring service).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Security upgrades","type":"text"}]},{"type":"paragraph","content":[{"text":"Chouette dependencies are constantly analyzed to find security issues. To handle ","type":"text"},{"text":"this tasks","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"0bac8c39-07f8-4a46-8254-4ad3bcf545ae"}}]},{"text":" Chouette ","type":"text"},{"text":"use","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4be907e8-a323-4fa2-8e85-e10937440bba"}}]},{"text":"s 2 tools : ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bundler-audit","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/rubysec/bundler-audit"}}]},{"text":" : check security issues for ruby libraries","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"snyk","type":"text","marks":[{"type":"link","attrs":{"href":"https://snyk.io/"}}]},{"text":" : check security issues for both ruby, javascript and go libraries ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"These libraries have been updated in this new release : ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"actionview to 5.2.4.2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shoulda-matchers to 4.1.2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nokogiri to 1.10.5","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Complete API documentation","type":"text"}]},{"type":"paragraph","content":[{"text":"Each API endpoint is now documented and public for both Chouette and IBOO SaaS:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chouette SaaS API documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://documenter.getpostman.com/view/9950294/Szf3aqMh?version=latest"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IBOO SaaS API documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://documenter.getpostman.com/view/9950294/SzKbNbY2?version=latest"}}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":2506,"id":"d07763ac-c934-47cb-9b2c-73fca782e3c2","collection":"contentId-343212043","type":"file","height":1241}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ara","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GTFS-RT Support","type":"text"}]},{"type":"paragraph","content":[{"text":"If the user adds a dedicated GTFS-RT broadcaster to a Partner, like ","type":"text"},{"text":"gtfs-rt-trip-updates-broadcaster","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"gtfs-rt-vehicle-positions-broadcaster","type":"text","marks":[{"type":"code"}]},{"text":", etc, Ara provides associated endpoints to retrieve real-time data in GTFS-RT with a simple HTTP request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET //gtfs\nGET //gtfs/trip-updates\nGET //gtfs/vehicle-positions","type":"text"}]},{"type":"paragraph","content":[{"text":"The user can select the expected GTFS-RT entities by using one of the GTFS-RT endpoints:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Global endpoint ","type":"text"},{"text":"//gtfs","type":"text","marks":[{"type":"code"}]},{"text":" provides all entities. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Trip Update endpoint ","type":"text"},{"text":"//gtfs/trip-updates","type":"text","marks":[{"type":"code"}]},{"text":" provides only Trip Update entities.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vehicle Position endpoint ","type":"text"},{"text":"//gtfs/vehicle-positions","type":"text","marks":[{"type":"code"}]},{"text":" provides only Vehicle Position entities","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Authentication","type":"text"}]},{"type":"paragraph","content":[{"text":"The user can specify a credential in the GTFS-RT request by using an HTTP header ","type":"text"},{"text":"Authorization","type":"text","marks":[{"type":"code"}]},{"text":" with this syntax : for ","type":"text"},{"text":"secret","type":"text","marks":[{"type":"code"}]},{"text":" token, ","type":"text"},{"text":"Authorization: Token token=secret","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"GET //gtfs\nAuthorization: Token token=secret","type":"text"}]},{"type":"paragraph","content":[{"text":"If a token is given into the GTFS-RT request, the Partner associated to the request will be find by ","type":"text"},{"text":"local_credential","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If no token is given into the GTFS-RT request, the Partner without ","type":"text"},{"text":"local_credential","type":"text","marks":[{"type":"code"}]},{"text":" will be associated to the request.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"GTFS-RT response","type":"text"}]},{"type":"paragraph","content":[{"text":"The GTFS-RT response contains a Feed Message structure as described in the ","type":"text"},{"text":"GTFS-RT reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/transit/gtfs-realtime/reference/"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The following content is managed by Ara:","type":"text"}]},{"type":"paragraph","content":[{"text":"FeedMessage","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FeedHeader","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Incrementality","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FeedEntity","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TripUpdate","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TripDescriptor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"StopTimeUpdate","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"StopTimeEvent","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VehiclePosition","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TripDescriptor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Position","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"All GTFS-RT responses respect this structure.","type":"text"}]},{"type":"paragraph","content":[{"text":"The TripUpdate entities are provided only if the user request selects them and if the ","type":"text"},{"text":"gtfs-rt-trip-updates-broadcaster","type":"text","marks":[{"type":"code"}]},{"text":" is associated to the Partner.","type":"text"}]},{"type":"paragraph","content":[{"text":"The VehiclePosition entities are provided only if the user request selects them and if the ","type":"text"},{"text":"gtfs-rt-vehicle-positions-broadcaster","type":"text","marks":[{"type":"code"}]},{"text":" is associated to the Partner.","type":"text"}]},{"type":"paragraph","content":[{"text":"Complete example (in pseudo json content):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"header\": {\n \"gtfs_realtime_version\": \"2.0\",\n \"incrementality\": \"FULL_DATASET\",\n \"timestamp\": \"1580136888\"\n },\n \"entity\": [\n {\n \"id\": \"trip:281721\",\n \"trip_update\": {\n \"trip\": {\n \"trip_id\": \"281721\",\n \"route_id\": \"3001I\",\n \"start_time\": \"16:36:00\"\n },\n \"stop_time_update\": [\n {\n \"stop_sequence\": 1,\n \"departure\": {\n \"time\": \"1580135775\"\n },\n \"stop_id\": \"1020503\"\n },\n {\n \"stop_sequence\": 2,\n \"arrival\": {\n \"time\": \"1580136050\"\n },\n \"departure\": {\n \"time\": \"1580136050\"\n },\n \"stop_id\": \"1174501\"\n },\n {\n \"stop_sequence\": 3,\n \"arrival\": {\n \"time\": \"1580136234\"\n },\n \"stop_id\": \"1250501\"\n }\n ]\n }\n },\n {\n \"id\": \"vehicle:943\",\n \"vehicle\": {\n \"trip\": {\n \"trip_id\": \"281721\",\n \"route_id\": \"3001I\",\n \"start_time\": \"16:36:00\"\n },\n \"position\": {\n \"latitude\": 60.27628707885742,\n \"longitude\": 24.856653213500977,\n \"bearing\": 133\n },\n \"vehicle\": {\n \"id\": \"943\"\n }\n }\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The completed specifications of the response contents are available in the ","type":"text"},{"text":"Ara GTFS-RT Broadcast documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://enroute.atlassian.net/wiki/spaces/PUBLIC/pages/383287427/GTFS-RT+Broadcasters"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported