Поиск автобусных маршрутов

/ Ресурсы / Документация / Поиск автобусных маршрутов

URL

http://api.citylife.kz/search/autobus_route(.json|.xml)[?параметры]&key=api_key

Параметры

ПараметрПо умолчаниюОписаниеТипПример
number0Номер маршрутаInt23
typeлюбойТип маршрута, прямой/обратныйString[Forward,backward]forward
disable_stoppings01 - Возвращать список остановок лежащих на маршрутеBool [0..n]1
town_id0Id города, 0 - все городаInt [0..n]1
page_number1Текущая страницаInt[1..n]5
items_per_page5Количество элементов на страницеInt[5..100]10
arrayed0Контейнер items будет оформлен, как массив объектов: items:[ {}, {}, {} ], а не как объект: items:{ {}, {}, {} }Int1
versionПоследняяВерсия APIString0.0.1

Пример 1

Найти автобусные маршруты с номером 23, в городе Астана
http://api.citylife.kz/search/autobus_route.xml?number=23&town_id=1&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>
        <results>
                <items>
                        <item>
                                <id>1234</id>
                                <number>23</number>
                                <polyline_hash>
                                71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,...
                                </polyline_hash>
                                <color>ff003399</color>
                                <type>forward</type>
                                <polyline_hash_arr>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.528724,51.144884</item>
                                        <item>71.517952,51.149095</item>
                                        <item>71.517952,51.149095</item>
                                        ...
                                        <item></item>
                                </polyline_hash_arr>
                                <id_str>41</id_str>
                                <number_str>23</number_str>
                                <town_id_str>1</town_id_str>
                                <town_id>1</town_id>
                                <stoppings_list>
                                        <item>
                                                <id>1234</id>
                                                <name>Название остановки</name>
                                                <coords>71.504847,51.148705</coords>
                                                <point_type>AUTOBUS_STOPPING</point_type>
                                                <specify_data>1, 2, 3, 4</specify_data>
                                                <coords_lat>51.148705</coords_lat>
                                                <coords_lng>71.504847</coords_lng>
                                                <address>Адрес остановки</address>
                                                <route_id>5678</route_id>
                                                <id_str>1234</id_str>
                                                <route_id_str>5678</route_id_str>
                                                <coords_lat_str>51.148705</coords_lat_str>
                                                <coords_lng_str>71.504847</coords_lng_str>
                                                <routes_list>
                                                        <item>
                                                                <id>99</id>
                                                                <id_str>99</id_str>
                                                                <number>1</number>
                                                        </item>
                                                        <item>
                                                                <id>98</id>
                                                                <id_str>98</id_str>
                                                                <number>2</number>
                                                        </item>
                                                        <item>
                                                                <id>97</id>
                                                                <id_str>97</id_str>
                                                                <number>3</number>
                                                        </item>
                                                        <item>
                                                                <id>96</id>
                                                                <id_str>96</id_str>
                                                                <number>4</number>
                                                        </item>
                                                </routes_list>
                                        </item>
                                        ...
                                        <item>...</item> 
                                </stoppings_list>
                        </item>
                        ...
                        <item> ... </item>
                </items>
                <total_count>999</total_count>
                <total_count_str>999</total_count_str>
                <pages_count>1</pages_count>
                <pages_count_str>1</pages_count_str>
                <current_page>1</current_page>
                <current_page_str>1</current_page_str>
        </results>
</citylife>

				

polyline_hash - координаты вершин ломанной (каждая вторая координата - это latitude)

polyline_hash_arr - координаты вершин ломанной

stoppings_list - остановки, лежащие на маршруте (routes_list - список маршрутов, проходящих через остановку)

Ответ в 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
    },
    "results": {
        "items": {
            "1234": {
                "id": 1234,
                "number": 23,
                "polyline_hash": "71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,71.528724,51.144884,...",
                "color": "ff003399",
                "type": "forward",
                "polyline_hash_arr": ["71.528724,51.144884", "71.528724,51.144884", "71.528724,51.144884", "71.528724,51.144884", ...],
                "id_str": "1234",
                "number_str": "23",
                "town_id_str": "1",
                "town_id": 1,
                "stoppings_list": {
                    "1234": {
                        "id": 1234,
                        "name": "\u0421\u0438\u043b\u0435\u0442\u0438",
                        "coords": "71.504847,51.148705",
                        "point_type": "AUTOBUS_STOPPING",
                        "specify_data": "1, 2, 3, 4",
                        "coords_lat": 51.148705,
                        "coords_lng": 71.504847,
                        "address": "Адрес остановки",
                        "route_id": 5678,
                        "id_str": "1234",
                        "route_id_str": "5678",
                        "coords_lat_str": "51.148705",
                        "coords_lng_str": "71.504847",
                        "routes_list": {
                            "99": {
                                "id": 99,
                                "id_str": "99",
                                "number": "1"
                            },
                            "98": {
                                "id": 98,
                                "id_str": "98",
                                "number": "2"
                            },
                            "97": {
                                "id": 97,
                                "id_str": "97",
                                "number": "3"
                            },
                            "96": {
                                "id": 96,
                                "id_str": "96",
                                "number": "4"
                            }
                        }
                    },
                    "999": { ... }
                }
            }
        },
        "total_count": "999",
        "total_count_str": "999",
        "pages_count": 999,
        "pages_count_str": "999",
        "current_page": 1,
        "current_page_str": "1"
    }
}
				

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

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