Справочник автозаправок

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

В нашей системе существует понятие «большая автозаправка» - это элемент в справочнике, которому принадлежат автозаправки. Например, «большой автозаправке «КакМунайГаз», принадлежат все автозаправки в стране

Для выборки автозаправок, необходимо знать ID большой автозаправки из справочника

URL

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

Параметры

ПараметрПо умолчаниюОписаниеТипПример
id0Id автозаправкиInt1
town_id0Id городаInt1
arrayed0Контейнер items будет оформлен, как массив объектов: items:[ {}, {}, {} ], а не как объект: items:{ {}, {}, {} }Int1

Пример 1

Получить список автозаправок города Астана
http://api.citylife.kz/reference/autocharges.xml?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>
        <found>
                <items>
                        <item>
                                <id_str>1234</id_str>
                                <id>1234</id>
                                <name>Название автозаправки</name>
                                <autocharges_count_str>99</autocharges_count_str>
                                <autocharges_count>99</autocharges_count>
                        </item>
                </items>
                <total_count>999</total_count>
                <total_count_str>999</total_count_str>
        </found>
</citylife>

				

autocharges_count - количество автозаправок «большой автозаправки». autocharges_count = 0 - означает, что таких автозаправок нет

Ответ в 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": {
            "1234": {
                "id_str": "1234",
                "id": 1234,
                "name": "Название автозаправки",
                "autocharges_count_str": "99",
                "autocharges_count": 99
            }
        },
        "total_count": 999,
        "total_count_str": "999"
    }
}
				

1234 - ID большой автозаправки

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

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