Ce guide explique comment intégrer Google pour offrir aux utilisateurs une expérience de recherche de transports en commun fluide sur différentes surfaces Google, y compris Google Maps et la recherche Google. De manière générale, les principales spécifications d'intégration sont les suivantes :
- Deux options sont disponibles pour fournir des données statiques :
- Intégration basée sur GTFS : fournissez un flux GTFS avec des extensions de billetterie si vous êtes le fournisseur des données d'horaires. Nous avons des exigences supplémentaires pour l'intégration basée sur GTFS.
- Intégration "arrêts uniquement" : fournissez uniquement une liste des arrêts, pour les cas où Google dispose déjà des données de planification provenant d'une autre source.
- Spécification d'une API de partenaire pour fournir des données dynamiques :
- Configuration du partenaire : fournissez des informations sur le partenaire, telles que le branding et les coordonnées.
- Serveur partenaire : serveurs d'implémentation compatibles avec les API du serveur partenaire.
Procédure d'intégration à Travel Transport
Vous trouverez ci-dessous la procédure à suivre pour créer et tester un système de bout en bout compatible avec les fonctionnalités de transport de Google. L'intégration comporte trois étapes principales :
- Consultez les conditions de participation.
- Fournir un flux de données statiques à Google.
- Prise en charge de l'API Travel Transport pour permettre les requêtes dynamiques sur les données qui évoluent rapidement, comme les prix et la disponibilité. L'API utilise les identifiants fournis par le flux de données statiques de l'étape 1, par exemple
ticketing_stop_id, pour identifier les arrêts.
1. Conditions de participation
Le module des fonctionnalités de transport de Google affiche les itinéraires et les options de réservation avec les prix. Pour que votre offre s'affiche dans la liste, vous devez fournir un lien de bonne qualité et un prix final correspondant. Pour en savoir plus, consultez nos conditions de participation.
2. Fournir un flux de données statiques
Deux options permettent de fournir des données statiques, chacune s'appliquant à des circonstances spécifiques. Le principal critère pour choisir l'option à utiliser est de savoir si vous êtes le fournisseur des données de planification pour les correspondances de transport en commun pour lesquelles vous souhaitez proposer une fonctionnalité de réservation. Le moyen le plus simple de vérifier si Google dispose déjà de données d'horaires est d'essayer de trouver des correspondances pour un opérateur spécifique sur Google Maps.
| Fonctionnalité | Intégration basée sur GTFS | Intégration "Arrêt uniquement" |
|---|---|---|
| Cas d'utilisation | Vous fournissez déjà le GTFS avec des informations sur les horaires et la billetterie. | Google dispose déjà des données de programmation de l'opérateur provenant d'une autre source. |
| Données requises | ID GTFS. | Liste de vos ID d'arrêts, avec leurs coordonnées géographiques. |
| Effort | Faible | Moyenne |
L'option 1 s'applique si vous êtes le fournisseur du flux GTFS pour un opérateur. Dans ce cas, vous devez également avoir configuré un flux GTFS pour fournir à Google les informations sur les horaires. Suivez ensuite les instructions de la section Intégration basée sur GTFS.
L'option 2 s'applique si Google reçoit déjà des données de programmation pour l'opérateur à partir d'une autre source. Dans ce cas, nous n'avons pas besoin de toutes les informations sur les horaires, mais nous avons toujours besoin d'une liste de vos ID d'arrêt que nous pouvons utiliser dans l'API Travel Transport (voir ci-dessous). Pour fournir la liste des arrêts, suivez les instructions de la section Intégration avec arrêt uniquement.
3. Assistance pour l'API Travel Transport
Pour être listé en tant que partenaire de réservation avec des prix dans l'unité de transport, Google doit pouvoir récupérer les dernières informations sur les prix et la disponibilité auprès des partenaires. Pour ce faire, les partenaires doivent fournir un service qui implémente les API Partner Server.
3.1. Implémenter l'API Partner Server
Pour savoir comment implémenter l'API Partner Server, consultez la documentation de référence de l'API et le guide Partner Server. L'API permet à Google d'obtenir les informations les plus récentes sur les prix et les disponibilités auprès des partenaires. Google l'utilisera pour :
- Générez un cache pour renvoyer rapidement les prix.
- Obtenez les derniers prix lorsqu'un utilisateur clique sur un itinéraire spécifique.
L'implémentation de l'API Partner Server est obligatoire si le partenaire souhaite que Google affiche les prix.
3.2. Validation et tests des API
Une fois l'implémentation de votre API presque terminée et le service l'implémentant opérationnel, veuillez contacter transport-help@google.com en fournissant les informations sur le serveur afin que nous puissions commencer à valider votre implémentation.
À l'avenir, nous prévoyons de proposer des outils automatisés pour valider l'implémentation de votre API, mais ils ne sont pas encore disponibles.