Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: Add Fares v2 page #89

Merged
merged 9 commits into from
Feb 10, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/assets/stylesheets/extra.css
Original file line number Diff line number Diff line change
Expand Up @@ -163,6 +163,12 @@ c {
min-width: 12em;
}

@media only screen and (min-width: 1219px) {
a:first-child {
margin-left: 0;
}
}

.usage-buttons > .button {
background-color: #172f50 !important;
}
Expand Down
70 changes: 70 additions & 0 deletions docs/extensions/fares-v2.de.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
<a class="pencil-link" href="https://github.com/MobilityData/gtfs.org/edit/main/docs/extensions/fare-extension.md" title="Edit this page" target="_blank">
<svg class="pencil" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"></path></svg>
</a>

# GTFS-Fares v2

Fares v2 ist ein GTFS Schedule-Erweiterungsprojekt, das darauf abzielt, die Einschränkungen von [Fares v1](/schedule/examples/fares-v1) zu beseitigen.

Die wichtigsten Konzepte, die Fares v2 darstellen soll, sind

- Tarifprodukte (z. B. Fahrscheine und Fahrkarten)
- Fahrgastkategorien (z. B. Senioren und Kinder)
- Zahlungsmöglichkeiten für Fahrpreise (z.B. Bankkarte und Kreditkarte)
- Fahrpreisbegrenzung

Diese Konzepte werden es den Datenproduzenten ermöglichen, zonenbasierte, zeitabhängige und verbundübergreifende Tarife zu modellieren. Dieses Erweiterungsprojekt wird in mehreren Iterationen angenommen.

Derzeit funktioniert die angenommene Basisimplementierung von Fares v2 für die folgenden Anwendungsfälle:

- Definition eines Fahrpreises
- Beschreibung von Servicestandorten in der gleichen Tarifzone
- Erstellen von Regeln für einfache Fahrten
- Erstellen von Regeln für Umsteigevorgänge

Sie können [hier Beispiele](/schedule/examples/fares-v2) sehen, die zeigen, was mit der angenommenen Fares v2 Basisimplementierung modelliert werden kann.

Hersteller können Tarif v2 im gleichen Datensatz wie Tarif v1 implementieren, da es keinen technischen Konflikt zwischen den beiden gibt. Die Verbraucher können wählen, welche Version sie unabhängig von der anderen verwenden möchten. Wenn Fares v2 angenommen und ausreichend unterstützt wird, kann Fares v1 in Zukunft veraltet sein.

<a class="button no-icon" href="https://share.mobilitydata.org/gtfs-fares-v2" target="_blank">Siehe den vollständigen Vorschlag</a>

## Laufende Arbeiten zu Fares v2

Die GTFS-Gemeinschaft arbeitet derzeit an der Fertigstellung des Vorschlags für [Tarifcontainer](https://share.mobilitydata.org/fare-containers-to-fare-payment-types-proposal).

Folgende Punkte werden derzeit diskutiert:

- Erstellung einer Tarif-Container-Datei
- Abstimmung darüber, welche Typen in die Aufzählung der Tarifcontainer-Optionen aufgenommen werden sollen

<a class="button no-icon" href="https://share.mobilitydata.org/slack" target="_blank">Treten Sie #gtfs-fares auf Slack bei</a><a class="button no-icon" href="https://www.eventbrite.ca/e/specifications-discussions-gtfs-fares-v2-monthly-meetings-tickets-522966225057" target="_blank">Siehe den Sitzungsplan</a><a class="button no-icon" href="https://docs.google.com/document/d/1d3g5bMXupdElCKrdv6rhFNN11mrQgEk-ibA7wdqVLTU/edit" target="_blank">Siehe Sitzungsnotizen</a>

## Erste Übernehmer

🎉 Aufruf an die Fares v2-Erstanwender! Mindestens 1 Datenproduzent und 1 Verbraucher müssen sich verpflichten, eine experimentelle Funktion zu implementieren, bevor eine öffentliche Abstimmung zur Aufnahme in die offizielle Spezifikation stattfindet. Diese Organisationen investieren viel Zeit und Energie in experimentelle Änderungen, um sicherzustellen, dass GTFS sich weiter entwickelt.

Bei der angenommenen Basisimplementierung waren die Erstanwender

- Produzenten: [Interline](https://www.interline.io/), [Maryland Department of Transportation](https://www.mta.maryland.gov/developer-resources), [Cal-ITP](https://dot.ca.gov/cal-itp/cal-itp-gtfs)
- Verbraucher: [Transit](https://transitapp.com/)

Für die derzeit diskutierte Funktion der Fahrpreiscontainer sind die Erstanwender

- Produzent: [Interline](https://www.interline.io/)
- Verbraucher: [Apple](https://www.apple.com/), [Transit](https://transitapp.com/)

<a class="button no-icon" href="https://docs.google.com/spreadsheets/d/1jpKjz6MbCD2XPhmIP11EDi-P2jMh7x2k-oHS-pLf2vI/edit?usp=sharing" target="_blank">Sehen Sie, wer die Dateien und Felder von Fares v2 verwendet</a>

## In der Diskussion befindliche Fares v2 Merkmale

<iframe src="https://portal.productboard.com/rhk8dbtic1iqakfznucry448" frameborder="0" width="100%", style="min-height:1060px"></iframe>

## Geschichte

- **2017**: Branchenforschung und Datenmodellierung
- **Oktober 2021**: [Entwurf der Basisimplementierung und gemeinsame Nutzung](https://github.com/google/transit/pull/286#issue-1026848880)
- **Dezember 2021**: [Offene Abstimmung #1 → nicht angenommen](https://github.com/google/transit/pull/286#issuecomment-990258396)
- **März 2022**: Offene [Abstimmung #2 → nicht angenommen](https://github.com/google/transit/pull/286#issuecomment-1080716109)
- **Mai 2022**: Offene [Abstimmung #3 → angenommen](https://github.com/google/transit/pull/286#issuecomment-1121392932)
- **August 2022**: [Diskussion der Gemeinschaft über die nächste Phase von Fares v2 beginnt](https://github.com/google/transit/issues/341)
- **Dezember 2022**: Die [Gemeinschaft legt eine Rangfolge der Funktionen fest, um die Iterationen zu priorisieren](https://github.com/google/transit/issues/341#issuecomment-1339947915)
70 changes: 70 additions & 0 deletions docs/extensions/fares-v2.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
<a class="pencil-link" href="https://github.com/MobilityData/gtfs.org/edit/main/docs/extensions/fare-extension.md" title="Edit this page" target="_blank">
<svg class="pencil" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"></path></svg>
</a>

# GTFS-Fares v2

Fares v2 es un proyecto de extensión de GTFS Schedule que pretende abordar las limitaciones de [Fares v1](/schedule/examples/fares-v1).

Los principales conceptos que Fares v2 tiene previsto representar son

- Productos tarifarios (por ejemplo, billetes y abonos)
- Categorías de usuarios (por ejemplo, mayores y niños)
- Opciones de pago (por ejemplo, tarjeta bancaria y tarjeta de crédito)
- Limitación de tarifas

Estos conceptos permitirán a los productores de datos modelar tarifas basadas en zonas, dependientes del tiempo e interinstitucionales. Este proyecto de ampliación se está adoptando por iteraciones.

En la actualidad, la implementación básica adoptada de Fares v2 funciona para los siguientes casos de uso:

- Definición de una tarifa de transporte
- Descripción de ubicaciones de servicio en la misma zona tarifaria
- Creación de normas para trayectos de ida
- Creación de normas para transbordos

[Aquí puede ver ejemplos](/schedule/examples/fares-v2) que muestran lo que se puede modelar utilizando la implementación base adoptada de Fares v2.

Los productores pueden implementar Fares v2 en el mismo conjunto de datos que Fares v1, ya que no existe ningún conflicto técnico entre ambas. Los consumidores pueden elegir qué versión utilizar independientemente de la otra. Con la adopción y el respaldo suficiente de Fares v2, Fares v1 podrá quedar obsoleta en el futuro.

<a class="button no-icon" target="_blank" href="https://share.mobilitydata.org/gtfs-fares-v2">Ver la propuesta completa</a>

## Trabajo en curso sobre Fares v2

La comunidad GTFS está trabajando actualmente en la finalización de la propuesta de [contenedores de tarifas](https://share.mobilitydata.org/fare-containers-to-fare-payment-types-proposal).

Entre los puntos actualmente en discusión figuran

- Creación de un archivo de contenedores de tarifas
- Alineación de los tipos que deben incluirse en la enumeración de opciones de contenedores de tarifas.

<a class="button no-icon" href="https://share.mobilitydata.org/slack" target="_blank">Únase a #gtfs-fares en Slack</a><a class="button no-icon" target="_blank" href="https://www.eventbrite.ca/e/specifications-discussions-gtfs-fares-v2-monthly-meetings-tickets-522966225057">Vea el calendario de reuniones</a><a class="button no-icon" target="_blank" href="https://docs.google.com/document/d/1d3g5bMXupdElCKrdv6rhFNN11mrQgEk-ibA7wdqVLTU/edit">Vea las notas de la reunión</a>.

## Primeros adoptantes

🎉 ¡Salud a los primeros en adoptar Fares v2! Al menos un productor de datos y un consumidor deben comprometerse a implementar una función experimental antes de que se abra una votación pública para añadirla a la especificación oficial. Estas organizaciones invierten una gran cantidad de tiempo y energía en cambios experimentales para garantizar que GTFS siga evolucionando.

En el caso de la implementación básica adoptada, los primeros en adoptarla fueron

- Productores: [Interline](https://www.interline.io/), [Maryland Department of Transportation](https://www.mta.maryland.gov/developer-resources), [Cal-ITP](https://dot.ca.gov/cal-itp/cal-itp-gtfs)
- Consumidores: [Transit](https://transitapp.com/)

Para la función de contenedores de tarifas actualmente en discusión, los primeros en adoptarla son

- Productores: [Interline](https://www.interline.io/)
- Consumidores: [Apple](https://www.apple.com/), [Transit](https://transitapp.com/)

<a class="button no-icon" target="_blank" href="https://docs.google.com/spreadsheets/d/1jpKjz6MbCD2XPhmIP11EDi-P2jMh7x2k-oHS-pLf2vI/edit?usp=sharing">Vea quién utiliza los archivos y campos de Fares v2</a>

## Características de las Fares v2 en discusión

<iframe src="https://portal.productboard.com/rhk8dbtic1iqakfznucry448" frameborder="0" width="100%", style="min-height:1060px"></iframe>

## Historia

- **2017**: Investigación del sector y modelización de datos
- **Octubre de 2021**: [Implementación base redactada y compartida](https://github.com/google/transit/pull/286#issue-1026848880)
- **Diciembre de2021**: [Votación abierta nº 1 → no aprobada](https://github.com/google/transit/pull/286#issuecomment-990258396)
- **Marzo de 2022**: [Votación abierta nº 2 → no aprobada](https://github.com/google/transit/pull/286#issuecomment-1080716109)
- **Mayo de 2022**: [Votación abierta nº 3 → aprobada](https://github.com/google/transit/pull/286#issuecomment-1121392932)
- **Agosto de 2022**: [Comienza el debate comunitario sobre la siguiente fase de Fares v2](https://github.com/google/transit/issues/341)
- **Diciembre de 2022**: [La comunidad identifica el orden de clasificación de las características para priorizar las iteraciones](https://github.com/google/transit/issues/341#issuecomment-1339947915)
72 changes: 72 additions & 0 deletions docs/extensions/fares-v2.fr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
<a class="pencil-link" href="https://github.com/MobilityData/gtfs.org/edit/main/docs/extensions/fare-extension.md" title="Edit this page" target="_blank">
<svg class="pencil" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"></path></svg>
</a>

# GTFS-Fares v2

Fares v2 est un projet d'extension du calendrier GTFS qui vise à remédier aux limitations de [Fares v1](/schedule/examples/fares-v1).

Les principaux concepts que Fares v2 prévoit de représenter sont les suivants

- Produits tarifaires (par exemple, les billets et les laissez-passer)
- Catégories d'usagers (par exemple, les personnes âgées et les enfants)
- Options de paiement des tarifs (par ex. carte bancaire et carte de crédit)
- le plafonnement des tarifs.

Ces concepts permettront aux producteurs de données de modéliser les tarifs par zone, en fonction de l'heure et entre agences. Ce projet d'extension est adopté par itérations.

Actuellement, l'implémentation de base adoptée de Fares v2 fonctionne pour les cas d'utilisation suivants :

- Définition d'un tarif de transport en commun
- Décrire les lieux de service dans la même zone tarifaire
- Création de règles pour les trajets simples
- Création de règles pour les transferts

Vous pouvez voir [ici des exemples](/schedule/examples/fares-v2) qui montrent ce qui peut être modélisé en utilisant l'implémentation de base adoptée de Fares v2.

Les producteurs peuvent mettre en œuvre Fares v2 dans le même ensemble de données que Fares v1, puisqu'il n'y a pas de conflit technique entre les deux. Les consommateurs peuvent choisir la version à utiliser indépendamment de l'autre. Avec l'adoption et l'approbation suffisante de Fares v2, Fares v1 peut être déprécié à l'avenir.

<a class="button no-icon" target="_blank" href="https://share.mobilitydata.org/gtfs-fares-v2">Voir la proposition complète</a>

## Travail en cours sur Fares v2

La communauté GTFS travaille actuellement à la finalisation de la proposition de [conteneurs tarifaires](https://share.mobilitydata.org/fare-containers-to-fare-payment-types-proposal).

Les points actuellement en discussion incluent :

- La création d'un fichier de conteneurs tarifaires
- Alignement sur les types qui devraient être inclus dans l'énumération des options de conteneurs tarifaires.

<a class="button no-icon" target="_blank" href="https://share.mobilitydata.org/slack">Rejoignez #gtfs-fares sur Slack</a>
<a class="button no-icon" target="_blank" href="https://www.eventbrite.ca/e/specifications-discussions-gtfs-fares-v2-monthly-meetings-tickets-522966225057">Voir le programme des réunions</a>
<a class="button no-icon" target="_blank" href="https://docs.google.com/document/d/1d3g5bMXupdElCKrdv6rhFNN11mrQgEk-ibA7wdqVLTU/edit">Voir les notes des réunions</a>

## Premiers adoptants

🎉 Chapeau bas aux premiers adoptants de Fares v2 ! Au moins un producteur de données et un consommateur doivent s'engager à mettre en œuvre une fonctionnalité expérimentale avant qu'un vote public ne soit ouvert pour l'ajouter à la spécification officielle. Ces organisations investissent une grande quantité de temps et d'énergie dans les changements expérimentaux pour s'assurer que GTFS continue à évoluer.

Pour l'implémentation de base adoptée, les premiers adoptants étaient

- Producteurs : [Interline](https://www.interline.io/), [Maryland Department of Transportation](https://www.mta.maryland.gov/developer-resources), [Cal-ITP](https://dot.ca.gov/cal-itp/cal-itp-gtfs)
- Consommateur : [Transit](https://transitapp.com/)

Pour la fonctionnalité de conteneurs tarifaires actuellement en discussion, les premiers adoptants sont

- Producteur : [Interline](https://www.interline.io/)
- Consommateur : [Apple](https://www.apple.com/), [Transit](https://transitapp.com/)

<a class="button no-icon" target="_blank" href="https://docs.google.com/spreadsheets/d/1jpKjz6MbCD2XPhmIP11EDi-P2jMh7x2k-oHS-pLf2vI/edit?usp=sharing">Voir qui utilise les fichiers et les champs de Fares v2</a>

## Fonctionnalités Fares v2 en cours de discussion

<iframe src="https://portal.productboard.com/rhk8dbtic1iqakfznucry448" frameborder="0" width="100%", style="min-height:1060px"></iframe>

## Historique

- **2017**: Recherche industrielle et modélisation des données
- **Octobre 2021**: [Rédaction et partage de l'implémentation de base](https://github.com/google/transit/pull/286#issue-1026848880)
- **Décembre 2021**: [Vote ouvert #1 → n'a pas été adopté](https://github.com/google/transit/pull/286#issuecomment-990258396)
- **Mars 2022**: [Vote ouvert #2 → n'a pas été adopté](https://github.com/google/transit/pull/286#issuecomment-1080716109)
- **Mai 2022**: [Vote ouvert #3 → adopté](https://github.com/google/transit/pull/286#issuecomment-1121392932)
- **Août 2022**: [Début de la discussion communautaire sur la prochaine phase de Fares v2](https://github.com/google/transit/issues/341).
- **Décembre 2022**: [la communauté identifie l'ordre de classement des fonctionnalités de la pile pour prioriser les itérations](https://github.com/google/transit/issues/341#issuecomment-1339947915).
Loading