Генерация глубокой ссылки
Генерация глубокой ссылки
Глубокая ссылка позволяет перейти на страницу точки отправления/ назначения или на страницу маршрута, не зная их точный URL-адрес. Для этого используется поиск по параметрам.
Чтобы сгенерировать глубокую URL-ссылку, выполните следующие действия:
1. Добавьте /search к URL:
2. Добавьте после /search get-параметры (get-параметры задаются в URL после знака "?") и передайте в них значения from (для точки Откуда) и/или to (для точки Куда).
При этом могут быть заданы обе точки from и to или только одна из них.
Например:
3. Если ссылка содержит неточное наименование точки (например, содержит наименование улицы, отеля и т.п), то производится поиск по аргументам, и по результатам поиска пользователь направляется на страницу маршрута, например по ссылке вида https://kiwitaxi.ru/search?from=izhevsk+svobody+173&to=kazan определится маршрут https://kiwitaxi.ru/russia/izhevsk-kazan
4. Обязательно следует применять URL-кодирование для значений параметров from и to. Это необходимо для того, чтобы сервер не принимал небуквенные символы в наименованиях точек отправления/ назначения в качестве параметров запроса. Например, знак & служит разделителем между двумя get-параметрами. Поэтому в адресах точек from/to, которые содержат знак & в своем наименовании ("Hotel & SPA" и т.п.), он должен быть заменен на %26.
5. Для добавления партнёрского маркера к полученной ссылке используйте знак &. Готовая ссылка будет выглядеть следующим образом: https://kiwitaxi.ru/search?from=colombo&to=tissamaharama&pap=59942b21df77e
Чтобы сгенерировать глубокую URL-ссылку, выполните следующие действия:
1. Добавьте /search к URL:
- для домена .ru получим: https://kiwitaxi.ru/search
- для домена .com следует при этом учитывать префикс локали (en, de, fr, es, pt, pl): https://kiwitaxi.com/es/search (здесь приведен пример для испанской локали)
2. Добавьте после /search get-параметры (get-параметры задаются в URL после знака "?") и передайте в них значения from (для точки Откуда) и/или to (для точки Куда).
При этом могут быть заданы обе точки from и to или только одна из них.
Например:
- строке вида https://kiwitaxi.ru/search?from=colombo&to=tissama... заданы оба параметра from и to, поэтому результатом поиска будет маршрут: https://kiwitaxi.ru/sri+lanka/colombo-tissamaharama
- в строке вида https://kiwitaxi.ru/search?from=hamburg задан параметр from, но не задан параметр to, происходит поиск точки отправления и адрес определяется как: https://kiwitaxi.ru/germany/hamburg
- в строке вида https://kiwitaxi.ru/search?to=malaga задан параметр to, но не задан параметр from, происходит поиск точки назначения и адрес определяется как: https://kiwitaxi.ru/spain/to/malaga
- в качестве get-параметра может быть указан результат из формы поиска, и тогда запрос будет иметь вид: https://kiwitaxi.ru/search?from=%D0%BA%D0%B5%D0%BC..., а результатом поиска в этом случае станет: https://kiwitaxi.ru/turkey/kemer
3. Если ссылка содержит неточное наименование точки (например, содержит наименование улицы, отеля и т.п), то производится поиск по аргументам, и по результатам поиска пользователь направляется на страницу маршрута, например по ссылке вида https://kiwitaxi.ru/search?from=izhevsk+svobody+173&to=kazan определится маршрут https://kiwitaxi.ru/russia/izhevsk-kazan
4. Обязательно следует применять URL-кодирование для значений параметров from и to. Это необходимо для того, чтобы сервер не принимал небуквенные символы в наименованиях точек отправления/ назначения в качестве параметров запроса. Например, знак & служит разделителем между двумя get-параметрами. Поэтому в адресах точек from/to, которые содержат знак & в своем наименовании ("Hotel & SPA" и т.п.), он должен быть заменен на %26.
5. Для добавления партнёрского маркера к полученной ссылке используйте знак &. Готовая ссылка будет выглядеть следующим образом: https://kiwitaxi.ru/search?from=colombo&to=tissamaharama&pap=59942b21df77e