{
 "schemaVersion": "1.0.0",
 "constitutionVersion": "1.0.0",
 "createdAt": "2026-08-12T00:00:00Z",
 "description": "Append-only Evidence Passport records. Old revisions are immutable; corrections create a new revision and preserve the previous permalink.",
 "entity": {
  "type": "project",
  "id": "helsinki-hsl-open-transit-api",
  "title": "HSL Open Transit Data & the Digitransit Platform",
  "canonicalUrl": "https://1001smartcities.org/projects/helsinki-hsl-open-transit-api/"
 },
 "currentRevisionId": "2026-10-05-baseline",
 "revisions": [
  {
   "id": "2026-10-05-baseline",
   "createdAt": "2026-10-05T22:28:54Z",
   "effectiveAt": "2026-10-05",
   "changeType": "baseline",
   "summary": "Created the first structured Evidence Passport with 8 claims and 6 source dossiers.",
   "preparedBy": {
    "type": "automation",
    "label": "AI-assisted evidence preparation",
    "humanApproved": false
   },
   "review": {
    "status": "unreviewed",
    "by": null,
    "date": null,
    "note": "Awaiting operator and domain-expert review; publication of this revision implies neither."
   },
   "changes": [
    {
     "operation": "add",
     "path": "/evidencePassport",
     "summary": "Added claim-level evidence mapping and source dossiers."
    },
    {
     "operation": "add",
     "path": "/revisionHistory",
     "summary": "Established a permanent, hash-addressed baseline revision."
    }
   ],
   "snapshotHash": "sha256:8dfdfa222f90d4dd272a0bb1ae12c6261eb88537270a50d76dff9e3efc8d2547",
   "snapshot": {
    "asOf": "2026-10-05",
    "projectFingerprint": "sha256:fd17badc9ada93c4718f0f9b5f30c4014c2d049440d3d8cf5e03fa1d850c8958",
    "assurance": {
     "status": "unreviewed",
     "scope": "evidence-passport-revision",
     "statement": "AI-assisted structural preparation. This revision has not been reviewed by a human or subject-matter expert.",
     "machineChecks": [
      "schema",
      "publication-diff-contract",
      "material-project-fingerprint",
      "claim-text-drift",
      "source-reference-resolution",
      "complete-source-dossier",
      "snapshot-hash"
     ]
    },
    "projectState": {
     "status": "live",
     "outcome": "succeeded",
     "evidenceGrade": "independent",
     "timeline": {
      "started": 2010,
      "ended": null
     }
    },
    "governance": {
     "operator": "HSL (Helsingin seudun liikenne)",
     "actorTypes": [
      "utility"
     ],
     "fundingModel": "public",
     "fundingDescription": null,
     "cost": null,
     "ownership": null,
     "decisionRights": null,
     "exitConditions": null
    },
    "claims": [
     {
      "id": "clm-e40d20aa257c4272",
      "field": "snippet",
      "text": "HSL opened its Journey Planner (Reittiopas) interface to developers in 2009-10",
      "statementKind": "quantitative",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-9a8828755bdebea8",
       "src-72d29596abde31cf"
      ],
      "supportNote": "HRI history: in 2008 developers discovered the existing interface; in 2009 the Apps4Finland organisers asked HSL about open interfaces and 'the decision is taken to make the interface public and to document it'; in 2010 'the open interface to its data is made public'. The HRI catalogue entry for the API dates from 16 March 2011.",
      "caveat": null,
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-fe34b83a032e5ba4",
      "field": "snippet",
      "text": "reaching 600 registered API users by May 2012",
      "statementKind": "quantitative",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-9a8828755bdebea8"
      ],
      "supportNote": "HRI history: '2012 The Journey Planner API has 600 registered users by May.'",
      "caveat": null,
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-ad2fcfd66f83cb35",
      "field": "snippet",
      "text": "HSL went on to co-develop Digitransit, an open-source journey-planning platform released in 2017",
      "statementKind": "quantitative",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-6b166a7737f3ae3b",
       "src-f90d6285c29f392d"
      ],
      "supportNote": "Forum Virium (2019): Digitransit 'has been developed in Finland by HSL, LMJ and Traficom' and is open source. The 2017 release year comes from the European Commission's OSOR case study.",
      "caveat": "The 2017 date rests on the OSOR case study alone; HSL's public-transport data was already running through Digitransit services alongside the older Reittiopas before then.",
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-ba04c0f7824c2ccf",
      "field": "snippet",
      "text": "now run by HSL, Fintraffic and Waltti Solutions",
      "statementKind": "descriptive",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-e8c4bd388a17a340"
      ],
      "supportNote": "Fintraffic: 'The journey planner service is produced, maintained and developed in a collaboration between HSL, Waltti Solutions Oy and Fintraffic.'",
      "caveat": null,
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-da4286b3e3c03fa9",
      "field": "snippet",
      "text": "which Estonia, several German cities and Oklahoma City also use",
      "statementKind": "descriptive",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-f90d6285c29f392d",
       "src-6b166a7737f3ae3b"
      ],
      "supportNote": "Forum Virium (2019): Estonia's Road Administration (Maanteeamet) began using Digitransit for its journey planner. The OSOR case study lists further instances in German cities (Herrenberg, Ludwigsburg, Aachen, Brandenburg) and Oklahoma City.",
      "caveat": "Oklahoma City rests on the OSOR case study alone; the local transit agency's own materials describe a trip planner without naming Digitransit.",
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-40d19100fb1f78cf",
      "field": "lesson",
      "text": "Helsinki's first step was cheap because the interface already existed: someone only had to tell developers about it",
      "statementKind": "descriptive",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-9a8828755bdebea8"
      ],
      "supportNote": "HRI: the Reittiopas service 'already had open data interfaces created previously. It was easy to get started with the unlocking of data: one had to simply tell others about the interface, although it had been originally designed for internal use.' HSL's manager: 'I only needed the approval of my superior and enough funding.'",
      "caveat": null,
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-0ec3f0db08f0eb48",
      "field": "lesson",
      "text": "Estonia's road administration adopted it expecting lower costs and a quicker timeframe",
      "statementKind": "descriptive",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-f90d6285c29f392d"
      ],
      "supportNote": "Forum Virium: Kaspar Karm of Maanteeamet: 'We're delighted to be starting technical and business cooperation, allowing us to benefit from Finnish knowledge and experience to deliver a new journey planner in Estonia with lower costs and a quicker timeframe.'",
      "caveat": "An expectation stated at adoption, not a measured saving.",
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     },
     {
      "id": "clm-3599545a823fa9fc",
      "field": "lesson",
      "text": "every adopter's improvements flow back to the others",
      "statementKind": "descriptive",
      "textMode": "verbatim-from-project-record",
      "mappingStatus": "mapped",
      "sourceRefs": [
       "src-f90d6285c29f392d"
      ],
      "supportNote": "Forum Virium's project manager Jari Honkonen: 'In an open platform all development results will be shared with others, therefore it is to everyone's benefit to have more partners who can participate in common development.'",
      "caveat": null,
      "interpretation": {
       "added": false,
       "interpolation": false,
       "note": "The passport copies the published claim and its recorded source mapping without adding a conclusion."
      }
     }
    ],
    "sources": [
     {
      "id": "src-72d29596abde31cf",
      "title": "Helsinki Region Infoshare (authority)",
      "url": "https://hri.fi/data/en_GB/dataset/hsl-reittiopas-api",
      "publisher": {
       "name": null,
       "domain": "hri.fi",
       "classification": "not-classified"
      },
      "sourceType": "web-page",
      "language": "und",
      "role": "claim-evidence",
      "claimRefs": [
       "clm-e40d20aa257c4272"
      ],
      "temporal": {
       "publishedAt": "2011-03-16",
       "updatedAt": "2023-03-28",
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "publication-and-record-dates-recorded"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Official open-data catalogue entry for the Reittiopas/Journey Planner API.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     },
     {
      "id": "src-6b166a7737f3ae3b",
      "title": "European Commission Interoperable Europe (independent)",
      "url": "https://interoperable-europe.ec.europa.eu/sites/default/files/inline-files/osor-case-study-of-digitransit.pdf",
      "publisher": {
       "name": null,
       "domain": "interoperable-europe.ec.europa.eu",
       "classification": "not-classified"
      },
      "sourceType": "pdf",
      "language": "und",
      "role": "claim-evidence",
      "claimRefs": [
       "clm-ad2fcfd66f83cb35",
       "clm-da4286b3e3c03fa9"
      ],
      "temporal": {
       "publishedAt": null,
       "updatedAt": null,
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "record-date-only"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Digitransit's 2017 release, HSL/Fintraffic/Waltti Solutions development, and adoption in Estonia, Germany and Oklahoma City.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     },
     {
      "id": "src-a250668c19e195db",
      "title": "Digitransit (operator)",
      "url": "https://www.fintraffic.fi/en/digitransit",
      "publisher": {
       "name": null,
       "domain": "fintraffic.fi",
       "classification": "not-classified"
      },
      "sourceType": "web-page",
      "language": "und",
      "role": "background",
      "claimRefs": [],
      "temporal": {
       "publishedAt": null,
       "updatedAt": null,
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "record-date-only"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Current, actively maintained routing/GTFS API documentation confirming the platform is still live.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     },
     {
      "id": "src-9a8828755bdebea8",
      "title": "Helsinki Region Infoshare — Helsinki Region's Public Transport Data (2 years of open data, 2013)",
      "url": "https://hri.fi/2years/8-hsln-joukkoliikennedata.html",
      "publisher": {
       "name": null,
       "domain": "hri.fi",
       "classification": "not-classified"
      },
      "sourceType": "web-page",
      "language": "und",
      "role": "claim-evidence",
      "claimRefs": [
       "clm-e40d20aa257c4272",
       "clm-fe34b83a032e5ba4",
       "clm-40d19100fb1f78cf"
      ],
      "temporal": {
       "publishedAt": null,
       "updatedAt": null,
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "record-date-only"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Timeline of the Journey Planner interface: discovered by developers in 2008, opened and documented after the 2009 Apps4Finland enquiry, made public in 2010, 600 registered API users by May 2012. HSL's project manager puts the cost of the open interfaces at about €60,000 over three years for the Journey Planner, against about €5 million for the whole service.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     },
     {
      "id": "src-e8c4bd388a17a340",
      "title": "Fintraffic — Digitransit",
      "url": "https://www.fintraffic.fi/fi/node/2239",
      "publisher": {
       "name": null,
       "domain": "fintraffic.fi",
       "classification": "not-classified"
      },
      "sourceType": "web-page",
      "language": "und",
      "role": "claim-evidence",
      "claimRefs": [
       "clm-ba04c0f7824c2ccf"
      ],
      "temporal": {
       "publishedAt": null,
       "updatedAt": null,
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "record-date-only"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Fintraffic: Digitransit is produced, maintained and developed by HSL, Waltti Solutions and Fintraffic; most public-transport journey planners in Finland are built on it; open-source code and open data interfaces.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     },
     {
      "id": "src-f90d6285c29f392d",
      "title": "Forum Virium Helsinki — Estonia adopts journey planning service first developed in Helsinki (19 Aug 2019)",
      "url": "https://forumvirium.fi/en/digitransit/",
      "publisher": {
       "name": null,
       "domain": "forumvirium.fi",
       "classification": "not-classified"
      },
      "sourceType": "web-page",
      "language": "und",
      "role": "claim-evidence",
      "claimRefs": [
       "clm-ad2fcfd66f83cb35",
       "clm-da4286b3e3c03fa9",
       "clm-0ec3f0db08f0eb48",
       "clm-3599545a823fa9fc"
      ],
      "temporal": {
       "publishedAt": "2019-08-19",
       "updatedAt": null,
       "sourceCheckedAt": null,
       "recordLastVerifiedAt": "2026-10-05",
       "dossierCreatedAt": "2026-10-05",
       "retrievedAt": null,
       "status": "publication-and-record-dates-recorded"
      },
      "locator": {
       "type": "descriptive-source-note",
       "value": "Estonia's Road Administration (Maanteeamet) adopts Digitransit for its national journey planner, expecting 'lower costs and a quicker timeframe'; in an open platform 'all development results will be shared with others'.",
       "exact": false
      },
      "preservation": {
       "archiveUrl": null,
       "archivedAt": null,
       "contentHash": null,
       "status": "not-captured"
      }
     }
    ],
    "coverage": {
     "claimsTotal": 8,
     "claimsMapped": 8,
     "sourcesTotal": 6,
     "sourcesUsedByClaims": 5,
     "sourcesWithPublicationDate": 2,
     "sourcesWithArchive": 0,
     "sourcesWithExactLocator": 0,
     "sourcesWithContentHash": 0
    },
    "limits": [
     "Publisher names and source languages have not yet been classified; domains are recorded without guessing.",
     "Existing source notes are descriptive locators, not page- or paragraph-exact citations.",
     "A missing archive, publication date or content hash is shown as null rather than inferred.",
     "The project-level evidence grade ranks the strongest source in the entry; it is not a truth score for every claim."
    ]
   }
  }
 ]
}
