General Transit Feed Specification (GTFS) est un format existant pour les horaires de transports en commun et les informations géographiques associées. L'intégration basée sur GTFS utilise GTFS et les extensions de billetterie Google Transports en commun pour réaliser l'étape 1 de l'intégration du transport, qui consiste à fournir un flux de données statiques.
L'API Partner Server utilise des identifiants tels que ticketing_trip_id
fournis par GTFS. Un flux GTFS valide doit donc exister avant de pouvoir utiliser l'API.
Veuillez suivre les étapes ci-dessous pour fournir un flux GTFS valide.
Créer un flux GTFS statique
Pour permettre aux utilisateurs de rechercher des itinéraires et des horaires pour des trajets interurbains à l'aide de l'intégration GTFS, les partenaires doivent fournir un flux GTFS. Les données du flux GTFS contiennent des informations statiques sur les horaires, les itinéraires et les informations de billetterie, qui sont ensuite utilisées par Google pour se connecter à l'API partenaire.
1. Créer un compte Google Transports en commun
Si ce n'est pas déjà fait, accédez à la page Premiers pas avec Google Transports en commun et utilisez le formulaire pour demander un compte. Une fois l'examen terminé, un compte sera créé et le tableau de bord GTFS sera disponible. Pour savoir comment accéder au tableau de bord des partenaires Google Transports en commun et le configurer, consultez Accéder au tableau de bord des partenaires Google Transports en commun.
2. Créer votre flux GTFS avec des extensions
Créez le flux GTFS qui doit inclure les sections obligatoires des extensions de billetterie Google Transports en commun (pour en savoir plus, consultez la section sur les extensions GTFS). Pour garantir la meilleure expérience utilisateur possible, veuillez lire et respecter les bonnes pratiques et exigences de qualité GTFS.
3. Nommer votre flux
La convention d'attribution de noms recommandée pour les flux est la suivante: agency-region-country_code
(par exemple, gbus-ca-us
) ou agency-country_code
si la région n'est pas requise (par exemple, gbus-br
). Pour les flux de test, la convention d'attribution de noms recommandée est test-agency-country_code
(par exemple, test-gbus-ca-us
ou test-gbus-br
).
4. Importation et mise à jour de votre flux
Suivez le guide Publier vos données de flux GTFS pour importer et mettre à jour vos données GTFS. Chaque fois que les données sont importées, elles sont soumises à une validation automatisée (qui peut prendre jusqu'à 30 minutes) et un rapport de validation est généré. Veuillez corriger les erreurs avant de passer à l'étape suivante.
5. Demander l'environnement d'aperçu
Une fois les données GTFS validées, suivez les instructions de la section Tester vos données de flux à l'aide de la prévisualisation privée pour activer l'environnement d'aperçu. Une fois cette option activée, les données de flux importées seront visibles sur Google Maps pour les utilisateurs autorisés. À ce stade, les données GTFS peuvent aussi être utilisées à des fins de test avec le serveur d'API.
6. Demander un examen lors du contrôle qualité pour le lancement
Une fois que les avertissements problématiques et les problèmes de qualité des données ont été résolus dans l'environnement d'aperçu, un examen final du contrôle qualité Google est requis avant le lancement public. Les problèmes détectés lors du contrôle qualité seront visibles dans le tableau de bord. Une fois tous les problèmes en suspens résolus, GTFS sera prêt à être lancé.
7. Lancement du flux
Pour savoir comment rendre votre flux public, consultez Lancer votre flux.