Справочник альтернативных поисковых слов

/ Ресурсы / Документация / Words suggestions

URL

http://api.citylife.kz/reference/word_suggestions(.json|.xml)?keyword=keyword&town_id=99&type=1[&параметры]&key=api_key

С помощью этого справочника, пользователю, который искал что-либо по слову «речторан», предложить поисковое слово «ресторан»

Параметры

ПараметрПо умолчаниюОписаниеТипПример
keyword *none«Плохое» ключевое слово (речторан), по этому слову будет произведен подбор «хороших» слов (ресторан)Stringречторан
town_id *noneId города, в котором искать альтернативые слова. Например, если в г.Алматы нет ресторанов, то и алтернативного слова предлагать нет смыслаInt1
type *noneПо слову keyword искали 1 – компанию или 2 – автобусную остановкуInt[1,2]1
arrayed0Контейнер items будет оформлен, как массив объектов: items:[ {}, {}, {} ], а не как объект: items:{ {}, {}, {} }Int1

* обязательный параметр

Пример 1

Получить список альтернативных слов в поиске автобусных остановок, в городе Астана, к слову «mega»
http://api.citylife.kz/reference/word_suggestions.xml?keyword=mega&town_id=1&type=2&key=X19nZXIxeURubFJUdldtYnBweks=

Ответ в XML

<?xml version="1.0" encoding="utf-8"?>
<citylife>
        <status>ok</status>
        <version>0.0.1</version>
        <error>0</error>
        <geo>
                <town_id>1</town_id>
                <town_name>Астана</town_name>
                <town_coords>71.437488,51.15226</town_coords>
                <country_id>KZ</country_id>
                <country_name>Казахстан</country_name>
                <town_id_str>1</town_id_str>
                <lng_str>71.437488</lng_str>
                <lng>71.437488</lng>
                <lat_str>51.15226</lat_str>
                <lat>51.15226</lat>
        </geo>
        <found>
                <items>
                        <item>мега</item>
			<item>торгово-развлекательный центр</item>
                </items>
                <total_count>2</total_count>
                <total_count_str>2</total_count_str>
        </found>
</citylife>

				

Ответ в JSON

{
    "status": "ok",
    "version": "0.0.1",
    "error": 0,
    "geo": {
        "town_id": 1,
        "town_name": "Астана",
        "town_coords": "71.437488,51.15226",
        "country_id": "KZ",
        "country_name": "Казахстан",
        "town_id_str": "1",
        "lng_str": "71.437488",
        "lng": 71.437488,
        "lat_str": "51.15226",
        "lat": 51.15226
    },
    "found": {
        "items": {
            "7": "мега",
            "8": "торгово-развлекательный центр"
        },
        "total_count": 2,
        "total_count_str": "2"
    }
}
				

Сообщить об ошибке

Нашли ошибку? Есть предложения по улучшению citylife? Сообщите нам! ;)