Формат поисковой ссылки

Для ссылок в результатах поиска партнеры предоставят базовый URL-адрес, специально предназначенный для поиска (см. раздел «Конфигурация партнера» ). Мы поддерживаем следующие параметры запроса:

Название поля Подробности
from_stop_id

(Повторяющийся) Идентификатор остановок, на которых может начаться поездка.

Значения stop_id для станций отправления.

to_stop_id

(Повторяющийся) Идентификатор остановок, на которых может закончиться поездка.

Значения stop_id станций назначения.

search_date

(Дата) День оказания услуг в ходе поездки.

Это поле содержит дату в следующем формате:

YYYYMMDD

lang

(IETF BCP 47, необязательно) Поле, используемое для указания выбранного языка сайта бронирования.

Значение этого поля соответствует стандарту IETF BCP 47, например en-US .

Если выбранный язык недоступен или поле не передано, сайт бронирования должен использовать резервный язык.

cur

(ISO 4217, необязательно) Поле, используемое для указания валюты, в которой должны отображаться цены.

Значение этого поля соответствует стандарту ISO 4217, например USD .

Если выбранная валюта не отображается или поле не заполнено, сайт бронирования должен использовать резервную валюту.

utm_source

(Строка, необязательно) Поле, используемое для указания основного сайта, с которого был отправлен трафик.

Возможные значения: google_search и google_maps .

Все повторяющиеся параметры задаются в виде массива JSON. Для from_stop_id и to_stop_id несколько значений представляют несколько станций в пунктах отправления и назначения.

Примеры

В этом примере пользователь запрашивает поезда из locality1 в locality2 :

  • locality1 соответствует станциям с stop_id f1 и f2 .
  • locality2 соответствует станциям с stop_id s t1 и t2 .
  • Дата оказания услуги: 20190716 .

В этом примере базовый URL-адрес — https://example.com .

Учитывая всю эту информацию, используйте следующие значения для параметров:

Название поля Подробности
from_stop_id ["f1" , "f2"]
to_stop_id ["t1" , "t2"]
service_date 20190716

Ниже представлен окончательный URI после кодирования:

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

На главной странице пользователь сможет просмотреть маршруты, отправляющиеся со станций f1 и f2 20190716 и прибывающие в t1 и t2 . Поддерживаются все комбинации станций:

  • От f1 до t1
  • От f1 до t2
  • От f2 до t1
  • От f2 к t2