Panoramica
Se non sei il fornitore dei feed GTFS per Google Maps, la tua integrazione è Solo fermate. Per questa integrazione dobbiamo capire come identifichi le diverse fermate di treni o autobus.
Specifiche generali dei feed
Quando avvii l'integrazione, creiamo un identificatore univoco per ogni
integrazione, ad esempio: ch_google_test (codice paese, nome del partner,
integrazione) o eu_google (codice regione, nome del partner).
I partner forniscono un file contenente file di testo in formato CSV che vengono applicati per integrazione. Ogni file CSV deve contenere una riga di intestazione con i nomi delle colonne che corrispondono al "Nome campo" specificato nella tabella delle specifiche del feed corrispondente.
Per consentire al partner di caricare nuove versioni dei file di fermate e mercati, il nostro team condividerà i dettagli della casella di posta SFTP, uno per ogni tipo di file, durante la procedura di onboarding.
Specifica della fermata (obbligatoria)
Il file di interruzione deve contenere le seguenti colonne:
| Nome campo | Tipo (vedi GTFS) | Descrizione |
|---|---|---|
stop_id |
ID (obbligatorio) | L'identificatore univoco che identifica una fermata o una stazione. Le stazioni più grandi devono contenere una sola voce. Viene utilizzato quando si effettuano chiamate all'API Partner Server e nei deep link dei ticket. |
stop_name |
Testo (obbligatorio) | Un nome leggibile per il debug della mappatura delle fermate, del riempimento della cache e dei dati sull'accuratezza dei prezzi. |
stop_lat |
Latitudine (obbligatoria) | La latitudine della fermata. |
stop_lon |
Longitudine (obbligatorio) | Longitudine della fermata. |
Utilizzeremo un processo di importazione automatizzato in cui i partner possono fornire continuamente file zip aggiornati quando le informazioni contenute al loro interno cambiano. Ad esempio, un partner può espandere l'inventario fornito estendendo l'elenco delle fermate. Tuttavia, come per GTFS, gli stop_id devono essere stabili.
(Facoltativo) Specifica del feed del set di mercati
Con le fermate mappate, generiamo il set di mercati per questa integrazione (un elenco contenente coppie di origine / destinazione popolari). Da qui, hai la possibilità di ridurre questo insieme di mercati fornendo un feed di insiemi di mercati.
Il set di mercati funge da lista consentita per il nostro servizio di riempimento della cache. Per impostazione predefinita, se non viene fornito alcun insieme di mercati, tutti i mercati sono abilitati. Se fornisci un insieme di mercati, verranno eseguiti query solo sui mercati inclusi nell'elenco. Se gli utenti eseguono query su mercati al di fuori di questo elenco consentito, i nostri sistemi invieranno comunque una query live per il mercato e la data specifici richiesti, ma non tenteremo di memorizzarli nella cache in modo proattivo.
Il file del set di mercati deve contenere le seguenti colonne:
| Nome campo | Tipo (vedi GTFS) | Descrizione |
|---|---|---|
origin_stop_id |
ID (obbligatorio) | L'origine stop_id del mercato. |
destination_stop_id |
ID (obbligatorio) | La destinazione stop_id del mercato. |
Configurazione partner
Quando utilizzi l'integrazione solo con le fermate, richiediamo informazioni aggiuntive per la configurazione statica del partner, come descritto nella sezione Configurazione partner.
Specifica dei link di referral
Il formato e i parametri del link di prenotazione (chiamato anche Ticketing link) sono
definiti in Link
per i biglietti
Parametri dell'API Partner
I parametri SegmentKeys per l'API Partner
(GetBulkTripOptionsRequest)
si basano sulla specifica del link diretto. Utilizziamo
SegmentKeys, tra cui
solo from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date,
boarding_time e arrival_time, lasciando ticketing_trip_id vuoto. Specificheremo
l'itinerario completo, inclusi tutti i trasferimenti, specificando più
SegmentKey, una per segmento.