Fast Search для отелей: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
 
(не показаны 3 промежуточные версии 3 участников)
Строка 1: Строка 1:
'''FastSearch''' перенаправит пользователя на страницу с результатами поиска или на форму с заполненными полями для осуществления поиска (в запросе необходимо указать fast_search, если этого параметра не будет, то поиск не будет запущен), подробнее по ссылке [[FastSearch - передача параметров в форму]]
+
[[Категория:Функции]]
 +
<!-- -->
 +
'''FastSearch''' перенаправит пользователя на страницу с результатами поиска или на форму с заполненными полями для осуществления поиска (в запросе необходимо указать fast_search, если этого параметра не будет, то поиск не будет запущен), подробнее по ссылке [[FastSearch - передача параметров в форму]].
  
Для указания данных для поиска отелей методом Fast Search можно использовать следующие параметры:
+
== FastSearch для Отелей 1.0==
 +
Для указания данных для поиска отелей методом FastSearch нужно использовать следующие параметры:
  
{| border="1"
+
{| class="wikitable"
|- bgcolor="#cccccc"
+
|-
! Переменная
+
! Параметр
 
! Значение
 
! Значение
 
|-
 
|-
 
| tarrival_point
 
| tarrival_point
| id города
+
| Идентификационный номер города в системе.<br/>
 +
Получить ID города для отелей можно с помощью ссылки
 +
<pre>http://nemo.travel/api/guide/autocomplete/cities/Город</pre>
 +
В ответе вы получите идентификаторы городов с привязкой к стране.
 
|-
 
|-
 
| hotel_category
 
| hotel_category
| количество звезд отеля (Число. Например "2" - поиск среди 1-2* отеля, "4" — среди 3-4* звездочного)
+
| Количество звезд отеля (Число. Например "2" - поиск среди 1-2* отеля, "4" — среди 3-4* звездочного)
 
|-
 
|-
 
| search_hotel_name
 
| search_hotel_name
| название гостиницы
+
| Название гостиницы
 
|-
 
|-
 
| arrival
 
| arrival
| дата заезда (формат - дд.мм.гггг)
+
| Дата заезда (формат - дд.мм.гггг)
 
|-
 
|-
 
| departure
 
| departure
| дата выезда (формат - дд.мм.гггг)
+
| Дата выезда (формат - дд.мм.гггг)
 
|-
 
|-
 
| max_price
 
| max_price
| предел цены, массив, его ключи ('amount' — максимальная цена, 'currency' — валюта максимальной цены)
+
| Предел цены, массив, его ключи ('amount' — максимальная цена, 'currency' — валюта максимальной цены)
 
|-
 
|-
 
| assignment
 
| assignment
| массив массивов. Каждый его элемент является массивом, ключами которого являются:
+
| Массив массивов. Каждый его элемент является массивом, ключами которого являются:
adults - количество взрослых в комнате<br/>children -количество детей в комнате (число)<br/>age0 - возраст 1го ребенка (число)<br/>age1 - возраст 2го ребенка<br/>age2 - возраст 3го ребенка<br/>age3 - возраст 4го ребенка<br/>infants - количество младенцев в комнате
+
adults - количество взрослых в комнате<br/>
 
+
children - количество детей в комнате (число)<br/>
 +
age0 - возраст 1го ребенка (число)<br/>
 +
age1 - возраст 2го ребенка<br/>
 +
age2 - возраст 3го ребенка<br/>
 +
age3 - возраст 4го ребенка<br/>
 +
infants - количество младенцев в комнате
 
|-
 
|-
 
| double
 
| double
| признак двуспальной кровати (принимает значения on/off)
+
| Признак двуспальной кровати (принимает значения on/off)
 
|}
 
|}
  
Примеры запросов для поиска:
+
=== Примеры запросов для поиска ===
 
 
 
Пункт прибывания: Санкт-Петербург, заезд: 17.01.2013, выезд: 24.01.2013 Комната 1: 1 взрослый (только с обязательными параметрами)
 
Пункт прибывания: Санкт-Петербург, заезд: 17.01.2013, выезд: 24.01.2013 Комната 1: 1 взрослый (только с обязательными параметрами)
 +
<pre>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.01.2013&departure=24.01.2013&assignment[0][adults]=1
 +
&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get</pre>
  
  <nowiki>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.01.2013&departure=24.01.2013&assignment</nowiki>[0][adults]=1&assignment[0][children]=0
+
Пункт пребывания: Санкт-Петербург, заезд: 17.02.2013, выезд: 24.02.2013, поиск среди 1-2* Комната 1: 1 взрослый, 1 ребенок Комната 2: 1 взрослый
&assignment[0][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get
 
  
Пункт прибывания: Санкт-Петербург, заезд: 17.02.2013, выезд: 24.02.2013, поиск среди 1-2* Комната 1: 1 взрослый, 1 ребенок Комната 2: 1 взрослый
+
<pre>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.02.2013&departure=24.02.2013&assignment[0][adults]=1
 +
&assignment[0][children]=1&assignment[0][infants]=0&assignment[1][adults]=1&assignment[1][children]=0&assignment[1][infants]=0
 +
&signOfSearchResults=0&ok=Поиск&param_by_get&hotel_category=2</pre>
  
  <nowiki>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.02.2013&departure=24.02.2013&assignment</nowiki>[0][adults]=1&assignment[0][children]=1
+
Пункт пребывания: Москва, заезд: 27.02.2013, выезд: 28.02.2013, цена до: 10000 руб, выбор по названию: Izmailovo gamma-delta Комната 1: 1 взрослый
&assignment[0][infants]=0&assignment[1][adults]=1&assignment[1][children]=0&assignment[1][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get&hotel_category=2
 
  
Пункт прибывания: Москва, заезд: 27.02.2013, выезд: 28.02.2013, цена до: 10000 руб, выбор по названию: Izmailovo gamma-delta Комната 1: 1 взрослый
+
<pre>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58165&search_hotel_name=Izmailovo+gamma-delta&arrival=27.02.2013&departure=28.02.2013
 +
&assignment[0][adults]=1<br>&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=1
 +
&ok=Поиск&param_by_get&max_price[amount]=10000&max_price[currency]=RUB&fast_search</pre>
  
  <nowiki>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58165&search_hotel_name=Izmailovo+gamma-delta&arrival=27.02.2013&departure=28.02.2013&assignment</nowiki>[0][adults]=1<br>&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=1&ok=Поиск&param_by_get&max_price[amount]=10000&max_price[currency]=RUB&fast_search
+
'''Для добавления комнаты'''
  
 +
Нужно добавить обязательный параметр assignment[n][adults] (где n - это порядковый номер комнаты, нумерация начинается с нуля) и можно не обязательные assignment[n][children], assignment[n][age0], assignment[n][age1], assignment[n][age2], assignment[n][age3], assignment[n][infants].
  
'''Для добавления комнаты'''
+
== FastSearch для Отелей 2.0 ==
 +
=== Параметры запроса ===
 +
Для ссылки доступны следующие переменные:
 +
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
 +
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
 +
! colspan="3" style="text-align:left;"| Параметры указания пассажиров в запросе поиска
 +
|-
 +
! scope="col" width="300" | Элемент
 +
! scope="col" width="250" | Формат ввода
 +
! scope="col" width="250" | Допустимые значения
 +
|-
 +
| rowspan="2" | Город || rowspan="2" |Код города из путеводителя || 58165
 +
|-
 +
|58166
 +
|-
 +
| rowspan="2" | Дата прибытия || rowspan="2" |Дата прибытия в формате '''ГГГГММДД''' || 20171118
 +
|-
 +
| -20171118
 +
|-
 +
| Дата выезда
 +
| Дата выезда в формате '''ГГГГММДД'''  
 +
| -20171119
 +
|-
 +
| rowspan="3"|Типы гостей, их количество и количество комнат ||rowspan="2"|Трехбуквенный '''код типа''' пассажира (ADT, CLD) с количеством || -ADT2
 +
|-
 +
| -ADT2CLD1
 +
|-
 +
| Распределение гостей по комнатам указывается через «-» || -ADT2CLD2-ADT3CLD1
 +
|-
 +
|}
 +
{{Attention| Все параметры должны быть разделены через «-».}}
 +
 
 +
=== Примеры запросов для поиска ===
 +
 
 +
* Запрос заполняет форму поиска отелей в Москве с датой въезда 09.07.2017 и датой выезда 10.07.2017 для двух взрослых в одной комнате и взрослого с ребенком во второй.
 +
<pre>http://SITEMANE/hotels/search/58165-20170709-20170710-ADT2-ADT1CLD1</pre>
  
Нужно добавить обязательный параметр assignment[n][adults] (где n - это порядковый номер комнаты, нумерация начинается с нуля) и можно не обязательные assignment[n][children], assignment[n][age0], assignment[n][age1], assignment[n][age2], assignment[n][age3], assignment[n][infants].
+
* Запрос заполняет форму поиска отелей в Санкт-Петербурге для трех взрослых в трех комнатах.
 +
<pre>http://SITEMANE/hotels/search/58166-ADT1-ADT1-ADT1</pre>
  
 +
* Запрос заполняет форму поиска отелей с датой въезда 08.08.2017 и датой выезда 16.08.2017 для двух взрослых в одной комнате.
 +
<pre>http://SITEMANE/hotels/search/20170808-20170816-ADT2</pre>
  
  
 
== См. также ==
 
== См. также ==
 
+
* [[FastSearch - передача параметров в форму]]
*[[Интеграция]]
+
* [[Интеграция]]

Текущая версия на 15:07, 10 сентября 2018

FastSearch перенаправит пользователя на страницу с результатами поиска или на форму с заполненными полями для осуществления поиска (в запросе необходимо указать fast_search, если этого параметра не будет, то поиск не будет запущен), подробнее по ссылке FastSearch - передача параметров в форму.

FastSearch для Отелей 1.0

Для указания данных для поиска отелей методом FastSearch нужно использовать следующие параметры:

Параметр Значение
tarrival_point Идентификационный номер города в системе.

Получить ID города для отелей можно с помощью ссылки

http://nemo.travel/api/guide/autocomplete/cities/Город

В ответе вы получите идентификаторы городов с привязкой к стране.

hotel_category Количество звезд отеля (Число. Например "2" - поиск среди 1-2* отеля, "4" — среди 3-4* звездочного)
search_hotel_name Название гостиницы
arrival Дата заезда (формат - дд.мм.гггг)
departure Дата выезда (формат - дд.мм.гггг)
max_price Предел цены, массив, его ключи ('amount' — максимальная цена, 'currency' — валюта максимальной цены)
assignment Массив массивов. Каждый его элемент является массивом, ключами которого являются:

adults - количество взрослых в комнате
children - количество детей в комнате (число)
age0 - возраст 1го ребенка (число)
age1 - возраст 2го ребенка
age2 - возраст 3го ребенка
age3 - возраст 4го ребенка
infants - количество младенцев в комнате

double Признак двуспальной кровати (принимает значения on/off)

Примеры запросов для поиска

Пункт прибывания: Санкт-Петербург, заезд: 17.01.2013, выезд: 24.01.2013 Комната 1: 1 взрослый (только с обязательными параметрами)

http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.01.2013&departure=24.01.2013&assignment[0][adults]=1
&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get

Пункт пребывания: Санкт-Петербург, заезд: 17.02.2013, выезд: 24.02.2013, поиск среди 1-2* Комната 1: 1 взрослый, 1 ребенок Комната 2: 1 взрослый

http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.02.2013&departure=24.02.2013&assignment[0][adults]=1
&assignment[0][children]=1&assignment[0][infants]=0&assignment[1][adults]=1&assignment[1][children]=0&assignment[1][infants]=0
&signOfSearchResults=0&ok=Поиск&param_by_get&hotel_category=2

Пункт пребывания: Москва, заезд: 27.02.2013, выезд: 28.02.2013, цена до: 10000 руб, выбор по названию: Izmailovo gamma-delta Комната 1: 1 взрослый

http://DOMAIN/index.php?go=hotel/search&tarrival_point=58165&search_hotel_name=Izmailovo+gamma-delta&arrival=27.02.2013&departure=28.02.2013
&assignment[0][adults]=1<br>&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=1
&ok=Поиск&param_by_get&max_price[amount]=10000&max_price[currency]=RUB&fast_search

Для добавления комнаты

Нужно добавить обязательный параметр assignment[n][adults] (где n - это порядковый номер комнаты, нумерация начинается с нуля) и можно не обязательные assignment[n][children], assignment[n][age0], assignment[n][age1], assignment[n][age2], assignment[n][age3], assignment[n][infants].

FastSearch для Отелей 2.0

Параметры запроса

Для ссылки доступны следующие переменные: Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.

Параметры указания пассажиров в запросе поиска
Элемент Формат ввода Допустимые значения
Город Код города из путеводителя 58165
58166
Дата прибытия Дата прибытия в формате ГГГГММДД 20171118
-20171118
Дата выезда Дата выезда в формате ГГГГММДД -20171119
Типы гостей, их количество и количество комнат Трехбуквенный код типа пассажира (ADT, CLD) с количеством -ADT2
-ADT2CLD1
Распределение гостей по комнатам указывается через «-» -ADT2CLD2-ADT3CLD1

Внимание! Все параметры должны быть разделены через «-».

Примеры запросов для поиска

  • Запрос заполняет форму поиска отелей в Москве с датой въезда 09.07.2017 и датой выезда 10.07.2017 для двух взрослых в одной комнате и взрослого с ребенком во второй.
http://SITEMANE/hotels/search/58165-20170709-20170710-ADT2-ADT1CLD1
  • Запрос заполняет форму поиска отелей в Санкт-Петербурге для трех взрослых в трех комнатах.
http://SITEMANE/hotels/search/58166-ADT1-ADT1-ADT1
  • Запрос заполняет форму поиска отелей с датой въезда 08.08.2017 и датой выезда 16.08.2017 для двух взрослых в одной комнате.
http://SITEMANE/hotels/search/20170808-20170816-ADT2


См. также