Поиск банкоматов

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

URL

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

Параметры

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

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

Пример 1

Найти банкоматы банка с ID = 19, в городе Астана
http://api.citylife.kz/search/cashdisp.xml?id=19&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>Адрес</address>
                                <city_id>1</city_id>
                                <coords>71.423733,51.175247</coords>
                                <specify_data>краткое описание банкомата</specify_data>
                                <point_type>CASH_DISPENSE</point_type>
                                <coords_lat>51.175247</coords_lat>
                                <coords_lng>71.423733</coords_lng>
                                <bank_id>19</bank_id>
                                <id_str>1234</id_str>
                                <bank_id_str>19</bank_id_str>
                                <coords_lat_str>51.175247</coords_lat_str>
                                <coords_lng_str>71.423733</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.423733,51.175247",
                "specify_data": "Краткое описание банкомата",
                "point_type": "CASH_DISPENSE",
                "coords_lat": 51.175247,
                "coords_lng": 71.423733,
                "bank_id": 19,
                "id_str": "1234",
                "bank_id_str": "19",
                "coords_lat_str": "51.175247",
                "coords_lng_str": "71.423733",
                "city_id_str": "1"
            }
        }
    }
}
				

1234 - это ID банкомата

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

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