Formato de vínculo de búsqueda

En el caso de los vínculos de búsqueda, los socios proporcionarán una URL base específica para la búsqueda (consulta Configuración del socio). Admitimos los siguientes parámetros de búsqueda:

Nombre del campo Detalles
from_stop_id

(Repetible) Es el identificador de las paradas en las que puede comenzar el viaje.

Son los valores de los stop_id de las estaciones de partida.
to_stop_id

(Repetible) Es el identificador de las paradas en las que puede finalizar el viaje.

Son los valores de los stop_id de las estaciones de destino.
search_date

(Fecha) Día de servicio del viaje.

Este campo contiene la fecha con la siguiente cadena de formato:

YYYYMMDD
lang

(IETF BCP 47, opcional) Campo que se usa para indicar el idioma seleccionado del sitio de reservas.

El valor de este campo cumple con el estándar BCP 47 del IETF, p.ej., en-US.

Si el idioma seleccionado no está disponible o no se pasa el campo, el sitio de reservas debe usar un idioma de resguardo.
cur

(ISO 4217, opcional) Campo que se usa para indicar la moneda en la que se deben mostrar los precios.

El valor de este campo cumple con la norma ISO 4217, p.ej., USD.

Si no se puede mostrar la moneda seleccionada o no se pasa el campo, el sitio de reservas debe usar una moneda de resguardo.
utm_source

(Cadena, opcional) Campo que se usa para indicar el sitio de nivel superior que envió el tráfico.

Los valores posibles son google_search y google_maps.

Todos los parámetros repetibles se especifican como un array JSON. En el caso de from_stop_id y to_stop_id, varios valores representan varias estaciones en las localidades de origen y destino.

Ejemplos

En este ejemplo, el usuario busca trenes de locality1 a locality2:

  • locality1 se asigna a estaciones con stop_ids f1 y f2.
  • locality2 se asigna a estaciones con stop_ids t1 y t2.
  • La fecha del servicio es 20190716.

Para este ejemplo, la URL base es https://example.com.

Con toda esta información, usa los siguientes valores para los parámetros:

Nombre del campo Detalles
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

A continuación, se muestra el URI final después de la codificación:

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

En la página de destino, el usuario podrá ver los itinerarios que salen de las estaciones f1 y f2 el 20190716 y llegan a t1 y t2. Se admiten todas las combinaciones de estaciones:

  • Desde f1 hasta t1
  • Desde f1 hasta t2
  • Desde f2 hasta t1
  • Desde f2 hasta t2