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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
 
(не показано 6 промежуточных версий 4 участников)
Строка 1: Строка 1:
−
'''FastSearch''' перенаправит пользователя на страницу с результатами поиска или на форму с заполненными полями для осуществления поиска, подробнее по ссылке [[FastSearch - передача параметров в форму ]]
+
[[Категория:Функции]]
 +
<!-- -->
 +
'''FastSearch''' перенаправит пользователя на страницу с результатами поиска или на форму с заполненными полями для осуществления поиска (в запросе необходимо указать fast_search, если этого параметра не будет, то поиск не будет запущен), подробнее по ссылке [[FastSearch - передача параметров в форму]].
  
−
Для указания данных для поиска отелей методом Fast Search можно использовать следующие параметры:  
+
== FastSearch для Отелей 1.0==
 +
Для указания данных для поиска отелей методом FastSearch нужно использовать следующие параметры:
  
−
<table border="1">
+
{| class="wikitable"
 +
|-
 +
! Параметр
 +
! Значение
 +
|-
 +
| tarrival_point
 +
| Идентификационный номер города в системе.<br/>
 +
Получить ID города для отелей можно с помощью ссылки
 +
<pre>http://nemo.travel/api/guide/autocomplete/cities/Город</pre>
 +
В ответе вы получите идентификаторы городов с привязкой к стране.
 +
|-
 +
| hotel_category
 +
| Количество звезд отеля (Число. Например "2" - поиск среди 1-2* отеля, "4" — среди 3-4* звездочного)
 +
|-
 +
| search_hotel_name
 +
| Название гостиницы
 +
|-
 +
| arrival
 +
| Дата заезда (формат - дд.мм.гггг)
 +
|-
 +
| departure
 +
| Дата выезда (формат - дд.мм.гггг)
 +
|-
 +
| max_price
 +
| Предел цены, массив, его ключи ('amount' — максимальная цена, 'currency' — валюта максимальной цены)
 +
|-
 +
| assignment
 +
| Массив массивов. Каждый его элемент является массивом, ключами которого являются:
 +
adults - количество взрослых в комнате<br/>
 +
children - количество детей в комнате (число)<br/>
 +
age0 - возраст 1го ребенка (число)<br/>
 +
age1 - возраст 2го ребенка<br/>
 +
age2 - возраст 3го ребенка<br/>
 +
age3 - возраст 4го ребенка<br/>
 +
infants - количество младенцев в комнате
 +
|-
 +
| double
 +
| Признак двуспальной кровати (принимает значения on/off)
 +
|}
  
−
<tr bgcolor="#cccccc">
+
=== Примеры запросов для поиска ===
−
<th>Переменная</th><th>Значение</th>
+
Пункт прибывания: Санкт-Петербург, заезд: 17.01.2013, выезд: 24.01.2013 Комната 1: 1 взрослый (только с обязательными параметрами)
−
</tr>
+
<pre>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.01.2013&departure=24.01.2013&assignment[0][adults]=1
−
<tr>
+
&assignment[0][children]=0&assignment[0][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get</pre>
−
<td>tarrival_point</td><td>id города</td>
 
−
</tr>
 
−
<tr>
 
  
−
<td>hotel_category</td><td>количество звезд отеля (Число. Например «2» - поиск среди 1-2* отеля, 4 — среди 3-4* звездочного)</td>
+
Пункт пребывания: Санкт-Петербург, заезд: 17.02.2013, выезд: 24.02.2013, поиск среди 1-2* Комната 1: 1 взрослый, 1 ребенок Комната 2: 1 взрослый
−
</tr>
 
−
<tr>
 
−
<td>hotel_name</td><td>id гостиницы</td>
 
−
</tr>
 
−
<tr>
 
−
<td>arrival</td><td>дата заезда (формат - дд.мм.гггг)</td>
 
  
−
</tr>
+
<pre>http://DOMAIN/index.php?go=hotel/search&tarrival_point=58166&arrival=17.02.2013&departure=24.02.2013&assignment[0][adults]=1
−
<tr>
+
&assignment[0][children]=1&assignment[0][infants]=0&assignment[1][adults]=1&assignment[1][children]=0&assignment[1][infants]=0
−
<td>departure</td><td>дата выезда (формат - дд.мм.гггг)</td>
+
&signOfSearchResults=0&ok=Поиск&param_by_get&hotel_category=2</pre>
−
</tr>
 
−
        <tr>
 
−
<td>max_price</td><td>предел цены, массив, его ключи ('amount' — максимальная цена, 'currency' — валюта максимальной цены)</td>
 
−
</tr>
 
−
        <tr>
 
−
<td>assignment</td><td>массив массивов. Каждый его элемент является массивом, ключами которого являются:
 
−
adults - количество взрослых в комнате <br> children -количество детей в комнате  (число) <br> age0 - возраст 1го ребенка (число)<br>
 
−
age1 - возраст 2го ребенка <br> age2 - возраст 3го ребенка <br> age3 - возраст 4го ребенка <br> infants - количество младенцев в комнате
 
  
−
</td> 
+
Пункт пребывания: Москва, заезд: 27.02.2013, выезд: 28.02.2013, цена до: 10000 руб, выбор по названию: Izmailovo gamma-delta Комната 1: 1 взрослый
−
        <tr>
 
−
<td>double</td><td>признак двуспальной кровати (принимает значения on/off)</td>
 
−
</tr>
 
−
</table>
 
  
−
Примеры запросов для поиска:
+
<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>
  
−
Пункт прибывания: Санкт-Петербург, заезд: 17.01.2013, выезд: 24.01.2013
+
'''Для добавления комнаты'''
−
Комната 1: 1 взрослый (только с обязательными параметрами)
 
  
−
  <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<br>&assignment[0][infants]=0&signOfSearchResults=0&ok=Поиск&param_by_get
+
Нужно добавить обязательный параметр assignment[n][adults] (где n - это порядковый номер комнаты, нумерация начинается с нуля) и можно не обязательные assignment[n][children], assignment[n][age0], assignment[n][age1], assignment[n][age2], assignment[n][age3], assignment[n][infants].
  
−
Пункт прибывания: Санкт-Петербург, заезд: 17.02.2013, выезд: 24.02.2013, поиск среди 1-2*
+
== FastSearch для Отелей 2.0 ==
−
Комната 1: 1 взрослый, 1 ребенок
+
=== Параметры запроса ===
−
Комната 2: 1 взрослый
+
Для ссылки доступны следующие переменные:
 +
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
 +
{| 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| Все параметры должны быть разделены через «-».}}
  
−
  <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<br>&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
+
=== Примеры запросов для поиска ===
  
−
'''Для добавления комнаты'''
+
* Запрос заполняет форму поиска отелей в Москве с датой въезда 09.07.2017 и датой выезда 10.07.2017 для двух взрослых в одной комнате и взрослого с ребенком во второй.
 +
<pre>http://SITEMANE/hotels/search/58165-20170709-20170710-ADT2-ADT1CLD1</pre>
 +
 
 +
* Запрос заполняет форму поиска отелей в Санкт-Петербурге для трех взрослых в трех комнатах.
 +
<pre>http://SITEMANE/hotels/search/58166-ADT1-ADT1-ADT1</pre>
  
−
Нужно добавить обязательный параметр assignment[n][adults] (где n - это порядковый номер комнаты, нумерация начинается с нуля) и можно не обязательные assignment[n][children], assignment[n][age0], assignment[n][age1], assignment[n][age2], assignment[n][age3], assignment[n][infants].
+
* Запрос заполняет форму поиска отелей с датой въезда 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


См. также

Источник — https://support.nemo.travel/index.php?title=Fast_Search_для_отелей&oldid=15119