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, viene creato un identificatore univoco per ogni integrazione, ad esempio: ch_google_test (codice paese, nome partner, integrazione) o eu_google (codice regione, nome partner).
I partner possono fornire un file ZIP contenente file di testo in formato CSV che vengono applicati a livello globale o per integrazione:
Esempio 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Esempio 2:
- stops.txt (applicato a tutte le integrazioni)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Specifica del feed di interruzione (obbligatoria)
Il file di arresto 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 per effettuare chiamate all'API Partner Server e nei link diretti per l'acquisto di biglietti. |
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) | Latitudine della fermata. |
stop_lon |
Longitudine (obbligatoria) | Longitudine della fermata. |
Utilizzeremo un processo di importazione automatizzato in cui i partner possono fornire continuamente file ZIP aggiornati quando le informazioni in essi contenute cambiano. Ad esempio, un partner potrebbe espandere l'inventario fornito estendendo l'elenco delle fermate. Tuttavia, come per GTFS, gli stop_ids devono essere stabili.
(Facoltativo) Specifica del feed per i set di mercati
Con le fermate mappate, generiamo l'insieme di mercato per questa integrazione (un elenco contenente coppie di origine / destinazione popolari). Da qui, hai la possibilità di ridurre questo insieme di mercati specificando un feed di mercato.
L'insieme di mercati funge da lista consentita: se non viene fornito alcun insieme di mercati, tutti i mercati vengono attivati nell'integrazione. Se viene fornito un insieme di mercati, tutti i mercati non presenti nell'elenco vengono disattivati.
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 per le fermate, sono necessarie informazioni aggiuntive per la configurazione del partner statico, come descritto nella sezione Configurazione del partner.
Link diretti per l'acquisto di biglietti
Il formato e i parametri di un link diretto sono definiti in Link per l'acquisto di biglietti
Parametri dell'API Partner
I parametri SegmentKeys per l'API Partner
(GetBulkTripOptionsRequest)
si basano sulla specifica del link diretto. Utilizziamo
SegmentKeys
inclusi solo from_ticketing_stop_time_id, to_ticketing_stop_time_id,
service_date, boarding_time e arrival_time, lasciando ticketing_trip_id
vuoto. Specificheremo completamente il percorso, inclusi tutti i trasferimenti, specificando più SegmentKey, uno per segmento.