Intégration basée sur GTFS

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.