Поиск автозаправок

/ Ресурсы / Документация / Поиск автозаправок

URL

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

Параметры

ПараметрПо умолчаниюОписаниеТипПример
id *noneID автозаправки (см. справочник автозаправок)Int3
town_id0Id города, 0 - все городаInt [0..n]1
lat0Если latitude и longitude переданы, то будет произведен поиск по радиусу и параметр town_id будет игнорироватьсяFloat51.153231618928096
lng0Float71.41371292993429
page_number1Текущая страницаInt[1..n]5
items_per_page5Количество элементов на страницеInt[5..100]10
arrayed0Контейнер items будет оформлен, как массив объектов: items:[ {}, {}, {} ], а не как объект: items:{ {}, {}, {} }Int1
versionПоследняяВерсия APIString0.0.1

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

Пример 1

Найти автозаправки с ID = 3 в городе Астана
http://api.citylife.kz/search/autocharge.xml?id=3&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>
                <total_count>999</total_count>
                <pages_count>999</pages_count>
                <current_page>1</current_page>
                <total_count_str>999</total_count_str>
                <pages_count_str>999</pages_count_str>
                <current_page_str>1</current_page_str>
                <items>
                        <item>
                                <id>1234</id>
                                <name>Название автозаправки</name>
                                <address>fhfhfgh</address>
                                <city_id>1</city_id>
                                <coords>71.426737,51.156567</coords>
                                <specify_data>Краткое описание</specify_data>
                                <point_type>AUTOCHARGE</point_type>
                                <coords_lng>71.426737</coords_lng>
                                <coords_lat>51.156567</coords_lat>
                                <id_str>1234</id_str>
                                <autocharge_id_str>3</autocharge_id_str>
                                <autocharge_id>3</autocharge_id>
                                <coords_lat_str>51.156567</coords_lat_str>
                                <coords_lng_str>71.426737</coords_lng_str>
                                <city_id_str>1</city_id_str>
                        </item>
                </items>
        </results>
</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
    },
    "results": {
        "total_count": 999,
        "pages_count": 999,
        "current_page": 1,
        "total_count_str": "999",
        "pages_count_str": "999",
        "current_page_str": "1",
        "items": {
            "1234": {
                "id": 1234,
                "name": "Название остановки",
                "address": "Адрес",
                "city_id": 1,
                "coords": "71.426737,51.156567",
                "specify_data": "Краткое описание",
                "point_type": "AUTOCHARGE",
                "coords_lng": 71.426737,
                "coords_lat": 51.156567,
                "id_str": "1234",
                "autocharge_id_str": "3",
                "autocharge_id": 3,
                "coords_lat_str": "51.156567",
                "coords_lng_str": "71.426737",
                "city_id_str": "1"
            }
        }
    }
}
				

1234 - это ID филиала очередной автозаправки

autocharge_id - это ID автозаправки из справочника

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

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