Présentation
Si vous n'êtes pas le fournisseur des flux GTFS pour Google Maps, votre intégration est Arrêt uniquement. Pour cette intégration, nous devons comprendre comment vous identifiez les différents arrêts de train ou de bus.
Spécifications générales du flux
Lorsque nous démarrons l'intégration, nous créons un identifiant unique pour chaque intégration, par exemple : ch_google_test (code pays, nom du partenaire, intégration) ou eu_google (code région, nom du partenaire).
Les partenaires peuvent fournir un fichier ZIP contenant des fichiers texte au format CSV appliqués globalement ou par intégration :
Exemple 1 :
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Exemple 2 :
- stops.txt (appliqué à toutes les intégrations)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Spécification du flux d'arrêt (obligatoire)
Le fichier d'arrêt doit contenir les colonnes suivantes :
| Nom du champ | Type (voir GTFS) | Description |
|---|---|---|
stop_id |
ID (obligatoire) | Identifiant unique d'un arrêt ou d'une station. Les stations plus grandes ne doivent contenir qu'une seule entrée. Il est utilisé lorsque vous appelez votre API de serveur partenaire et dans les liens profonds de billetterie. |
stop_name |
Texte (obligatoire) | Nom lisible pour le débogage de la cartographie des arrêts, du remplissage du cache et des données d'exactitude des prix. |
stop_lat |
Latitude (obligatoire) | Latitude de l'arrêt. |
stop_lon |
Longitude (obligatoire) | Longitude de l'arrêt. |
Nous utiliserons un processus d'ingestion automatisé permettant aux partenaires de fournir en continu des fichiers ZIP mis à jour lorsque les informations qu'ils contiennent changent. Par exemple, un partenaire peut élargir l'inventaire fourni en étendant la liste des arrêts. Toutefois, comme dans GTFS, les identifiants d'arrêt doivent être stables.
Spécifications du flux de marché (facultatif)
Avec les arrêts mappés, nous générons l'ensemble de marchés pour cette intégration (une liste contenant des paires d'origine / destination populaires). Vous pouvez ensuite réduire cet ensemble de marchés en fournissant un flux d'ensemble de marchés.
L'ensemble de marchés agit comme une liste d'autorisation : si aucun ensemble de marchés n'est fourni, tous les marchés sont activés dans l'intégration. Si un ensemble de marchés est fourni, tous les marchés qui ne figurent pas dans la liste sont désactivés.
Le fichier de marché doit contenir les colonnes suivantes :
| Nom du champ | Type (voir GTFS) | Description |
|---|---|---|
origin_stop_id |
ID (obligatoire) | stop_id d'origine du marché. |
destination_stop_id |
ID (obligatoire) | stop_id de destination du marché. |
Configuration des partenaires
Lorsque vous utilisez l'intégration "Arrêt uniquement", nous avons besoin d'informations supplémentaires pour la configuration du partenaire statique, comme indiqué dans la section Configuration du partenaire.
Liens profonds de billetterie
Le format et les paramètres d'un lien profond sont définis dans Liens de billetterie.
Paramètres de l'API Partner
Les paramètres SegmentKeys de l'API Partner (GetBulkTripOptionsRequest) sont basés sur la spécification de lien profond. Nous utilisons des SegmentKeys qui n'incluent que from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time et arrival_time, en laissant ticketing_trip_id vide. Nous spécifierons entièrement l'itinéraire, y compris toutes les correspondances, en spécifiant plusieurs clés de segment, une par segment.