Ce glossaire définit les termes clés utilisés dans la documentation sur l'intégration des partenaires de transport.
Jeton de réservation : chaîne facultative générée par le partenaire qui peut être transmise dans le lien profond de billetterie pour aider à maintenir la cohérence des prix et des itinéraires entre les résultats de recherche de Google et la page de réservation du partenaire.
Mappage JSON canonique : ensemble spécifique de règles définies par les Protocol Buffers pour convertir un message proto en objet JSON. Cette intégration nécessite d'utiliser ce mappage avec des options spécifiques afin que les requêtes et les réponses soient correctement mises en forme.
GTFS (General Transit Feed Specification) : format de données standard utilisé par les agences de transports en commun pour fournir aux passagers des informations sur les horaires, les itinéraires et les tarifs. Dans cette intégration, il s'agit de l'une des deux méthodes permettant de fournir des données statiques à Google.
Intégration basée sur GTFS : méthode d'intégration destinée aux partenaires qui fournissent leurs propres données de planification à Google dans un flux GTFS. Cette option est utilisée lorsque Google ne dispose pas encore des plannings de l'opérateur.
known_itineraries : option de la configuration du partenaire qui permet aux partenaires de recevoir une liste des itinéraires connus de Google pour optimiser leur réponse.
Ensemble de marchés : (pour l'intégration Stop-only) flux facultatif fourni par le partenaire pour définir une liste spécifique de paires origine-destination (marchés) pour lesquelles il fournira des tarifs. Si elle est fournie, elle sert de liste d'autorisation.
API partenaire / API serveur partenaire : ensemble d'API que les partenaires doivent implémenter pour fournir à Google des données dynamiques, telles que les prix et la disponibilité en temps réel.
Tests de qualité des prix : processus continu dans lequel les robots d'exploration de Google échantillonnent les séjours sur le site Web du partenaire pour vérifier que les prix affichés aux utilisateurs correspondent à ceux fournis via l'API Partner.
RPS (requêtes par seconde) : taux moyen auquel Google envoie des requêtes (une requête correspond à une demande) au serveur de l'API du partenaire. Ce taux peut fluctuer, avec des périodes de trafic légèrement plus élevé ou plus faible.
SegmentKey : objet utilisé dans l'API Partner pour identifier de manière unique une seule étape d'un trajet, y compris l'origine, la destination et les dates/heures de service.
service_date : date spécifique à laquelle un service de transport en commun fonctionne, au format YYYYMMDD. Il est utilisé en combinaison avec d'autres identifiants pour spécifier une instance de trajet unique.
Intégration "arrêt uniquement" : méthode d'intégration pour les partenaires qui ne sont pas la source des données de programmation. Cette option est utilisée lorsque Google reçoit déjà les horaires de l'opérateur d'une autre source. Les partenaires n'ont qu'à fournir une liste de leurs ID d'arrêt.
ticketing_stop_id : identifiant unique du partenaire pour un arrêt ou une station.
Cet ID est fourni dans le flux de données statiques (GTFS ou Arrêts uniquement). Il est utilisé dans l'API Partner et les liens profonds de billetterie.
ticketing_trip_id : (pour l'intégration basée sur GTFS) identifiant unique du partenaire pour un trajet spécifique, fourni dans le fichier trips.txt de son flux GTFS. Intégrations basées sur GTFS uniquement.
Lien profond de billetterie : URL qui redirige un utilisateur depuis les résultats de recherche Google vers le site Web du partenaire pour réserver un itinéraire spécifique. L'URL contient des informations encodées sur le trajet sélectionné.
TripOptionsErrorType : ensemble spécifique de types d'erreurs pouvant être renvoyés dans l'API Partner pour fournir des informations plus détaillées sur la raison pour laquelle une requête a échoué.
UNSPECIFIED Valeur Enum : première valeur requise (avec une valeur numérique de 0) dans toute définition d'énumération lors de l'utilisation de Protocol Buffers. Il sert de valeur par défaut et doit généralement être traité comme une erreur s'il est reçu dans une requête.