Formato del link di ricerca

Per i link di ricerca, i partner forniranno un URL di base specifico per la ricerca (vedi Configurazione partner). Sono supportati i seguenti parametri di query:

Nome campo Dettagli
from_stop_id

(Ripetibile) Identificatore delle fermate in cui può iniziare la corsa.

I valori degli stop_id delle stazioni di partenza.
to_stop_id

(Ripetibile) Identificatore delle fermate in cui può terminare il viaggio.

I valori delle stop_id delle stazioni di destinazione.
search_date

(Data) Giorno del servizio del viaggio.

Questo campo contiene la data con la seguente stringa di formato:

YYYYMMDD
lang

(Facoltativo, IETF BCP 47) Campo utilizzato per indicare la lingua selezionata del sito di prenotazione.

Il valore di questo campo è conforme a IETF BCP 47, ad esempio en-US.

Se la lingua selezionata non è disponibile o il campo non viene trasmesso, il sito di prenotazione deve utilizzare una lingua di riserva.
cur

(ISO 4217, facoltativo) Campo utilizzato per indicare la valuta in cui devono essere visualizzati i prezzi.

Il valore di questo campo è conforme alla normativa ISO 4217, ad esempio USD.

Se la valuta selezionata non può essere visualizzata o il campo non viene trasmesso, il sito di prenotazione deve utilizzare una valuta di riserva.
utm_source

(Stringa, facoltativo) Campo utilizzato per indicare il sito di primo livello che ha inviato il traffico.

I valori possibili sono google_search e google_maps.

Tutti i parametri ripetibili sono specificati come matrice JSON. Per from_stop_id e to_stop_id, più valori rappresentano più stazioni nelle località di partenza e di destinazione.

Esempi

In questo esempio, l'utente cerca treni da locality1 a locality2:

  • locality1 mappa delle stazioni con stop_id f1 e f2.
  • locality2 mappa delle stazioni con stop_id t1 e t2.
  • La data del servizio è 20190716.

Per questo esempio, l'URL di base è https://example.com.

Tenendo conto di tutte queste informazioni, utilizza i seguenti valori per i parametri:

Nome campo Dettagli
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

Di seguito è riportato l'URI finale dopo la codifica:

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

Nella pagina di destinazione, l'utente potrà visualizzare gli itinerari in partenza dalle stazioni f1 e f2 il giorno 20190716 e in arrivo a t1 e t2. Sono supportate tutte le combinazioni di stazioni:

  • Da f1 a t1
  • Da f1 a t2
  • Da f2 a t1
  • Da f2 a t2