Справочник городов

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

URL

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

Параметры

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

Пример 1

Найти города Казахстана
http://api.citylife.kz/reference/towns.xml?country_code=kz&key=X19nZXIxeURubFJUdldtYnBweks=

Ответ в XML

<?xml version="1.0" encoding="utf-8"?>
<citylife>
        <status>ok</status>
        <version>0.0.1</version>
        <error>0</error>
        <found>
                <items>
                        <item>
                                <town_id>1234</town_id>
                                <town_name>Название города</town_name>
                                <coords>73.070501,50.216897</coords>
                                <country_code>KZ</country_code>
                                <country_name>Название страны</country_name>
                                <lng>73.070501</lng>
                                <lat>50.216897</lat>
                                <lng_str>73.070501</lng_str>
                                <lat_str>50.216897</lat_str>
                                <town_id_str>1234</town_id_str>
                        </item>
                        ...
                        <item>...</item>
                </items>
                <total_count>999</total_count>
                <total_count_str>999</total_count_str>
        </found>
</citylife>
				

Ответ в JSON

{
    "status": "ok",
    "version": "0.0.1",
    "error": 0,
    "found": {
        "items": {
            "1234": {
                "town_id": 1234,
                "town_name": "Название города",
                "coords": "73.070501,50.216897",
                "country_code": "KZ",
                "country_name": "Название страны",
                "lng": 73.070501,
                "lat": 50.216897,
                "lng_str": "73.070501",
                "lat_str": "50.216897",
                "town_id_str": "1234"
            },
            "9999": { ... }
        },
        "total_count": 999,
        "total_count_str": "999"
    }
}
				

1234 - ID города

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

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