API выгрузки данных о городах, областях, регионах, странах

Набор API для получения информации обо всех городах, областях, регионах, странах.

Получение частей света

Структура API запроса для получения всех частей света:

http://htmlweb.ru/geo/api.php?locations&json&api_key=API_KEY_из_профиля

Получение всех стран или список стран указанной части света

Структура API запроса для получения всех областей(регионов, штатов) указанной страны:

http://htmlweb.ru/geo/api.php?location=ЧАСТЬ_СВЕТА&json&api_key=API_KEY_из_профиля

Для получения всех стран Европы:
http://htmlweb.ru/geo/api.php?location=Европа&json&api_key=API_KEY_из_профиля

Для получения всех стран передайте пустое location.

Для получения только кодов и названий, передайте параметр short.

Ответ:

{"0":{"name":"Австрия","fullname":"Австрийская Республика","english":"Austria","id":"AT","country_code3":"AUT","iso":"040","telcod":43,"location":"Европа","capital":2440,"mcc":232,"lang":"немецкий","langcod":"de"},
"1":{"name":"Албания","fullname":"Республика Албания","english":"Albania","id":"AL","country_code3":"ALB","iso":"008","telcod":355,"location":"Европа","capital":2593,"mcc":276,"lang":"албанский","langcod":"sq"},
...

Получение всех областей(регионов, штатов) указанной страны

Структура API запроса для получения всех областей(регионов, штатов) указанной страны:

http://htmlweb.ru/geo/api.php?country=КОД_СТРАНЫ&json&api_key=API_KEY_из_профиля

Например, для получения всех областей и округов России:

http://htmlweb.ru/geo/api.php?country=ru&json&api_key=API_KEY_из_профиля

Для получения одной записи "Республика Крым" в формате sql: http://htmlweb.ru/geo/api.php?country=ru&id=115&sql&api_key=API_KEY_из_профиля

Также вы можете задать альтернативные форматы xml, html или sql:

http://htmlweb.ru/geo/api.php?country=ru&xml&api_key=API_KEY_из_профиля
http://htmlweb.ru/geo/api.php?country=ru&html&api_key=API_KEY_из_профиля
http://htmlweb.ru/geo/api.php?country=ru&sql&api_key=API_KEY_из_профиля

Кодовая страница по умолчанию для sql формата utf-8. Для выгрузки в формате windows-1251 добавьте параметр &charset=windows-1251

Если формат не указан, формируется список option для select-запроса

* Ограничение


Получение всех районов указанной области(региона, штата)

Структура API запроса для получения всех областей(регионов, штатов) указанной страны:

http://htmlweb.ru/geo/api.php?area_rajon=КОД_ОБЛАСТИ&json&api_key=API_KEY_из_профиля

КОД_ОБЛАСТИ - поле id в ответе на запрос "Список всех областей"

Например, для получения всех областей и округов Амурской области России:

http://htmlweb.ru/geo/api.php?area_rajon=5&json&api_key=API_KEY_из_профиля

Получение всех городов указанного района внутри области

Структура API запроса для получения всех городов указанного района внутри области:

http://htmlweb.ru/geo/api.php?rajon_city=КОД_РАЙОНА&json&api_key=API_KEY_из_профиля

КОД_РАЙОНА - поле id в ответе на запрос "Список всех районов области"

* Ограничение


Получение всех городов указанной области(региона, штата) без деления на районы

Структура API запроса для получения всех городов :

http://htmlweb.ru/geo/api.php?area=КОД_ОБЛАСТИ&json&api_key=API_KEY_из_профиля

КОД_ОБЛАСТИ - поле id в ответе на запрос "Список всех областей"

Например, для получения всех городов Амурской области России:

http://htmlweb.ru/geo/api.php?area=5&json&api_key=API_KEY_из_профиля

Для включения в выборку только крупных городов добавьте параметр level=2. Если хотите получить только крупнейшие города, добавьте параметр level=1.

Для получения ответа в формате MySql используйте параметр sql[=имя_таблицы]:

Например, для получения всех городов Амурской области России:

http://htmlweb.ru/geo/api.php?area=5&sql&api_key=API_KEY_из_профиля
INSERT IGNORE INTO `region` ( `id`, `name`, `area`, `telcod`, `latitude`, `longitude`, `time_zone`, `english`, `rajon`, `country`, `sound`) VALUES ('288', 'Айгунь', '5', '', '49.978001', '127.489998', null, 'aygun\'', '0', 'RU', 'A250'); и т.д.

* Ограничение

Информация о городе по id

Для получения информации о конкретном городе по id в формате json выполните следующий запрос:

http://htmlweb.ru/geo/api.php?city=1&json

Для получения краткой информации о конкретном городе по id в формате json выполните следующий запрос:

http://htmlweb.ru/geo/api.php?city=1&json&short

Для получения строки в формате SQL для сохранения в базу с указанием списка полей, выполните следующий запрос:

http://htmlweb.ru/geo/api.php?city=1&sql=pb_city&fields=id,name,english,area,rajon,country

Информация о стране по коду или названию

Для получения информации о стране по id в формате json выполните следующий запрос:

https://htmlweb.ru/geo/api.php?country=ru&info&json

Для получения краткой информации о конкретном городе по названию в формате json выполните следующий запрос:

https://htmlweb.ru/geo/api.php?country=Россия&json&info&short&charset=utf-8

Информация о регионе(штате,области) по коду

Для получения информации о стране по id в формате json выполните следующий запрос:

https://htmlweb.ru/geo/api.php?area=1&info&json

API получения списка городов (населенных пунктов) по части названия города

Структура API запроса для получения списка городов по части названия:

http://htmlweb.ru/geo/api.php?city_name=москва&json&api_key=API_KEY_из_профиля

Ответ:

{"limit":46,
"0":{"id":1,"name":"Москва","area":1,"telcod":"495,499","latitude":55.755787,"longitude":37.617634,"time_zone":4,"english":"Moscow","rajon":3597,"country":"RU","sound":"M210","level":1,"iso":"MOW","vid":1,"full_name":"Москва (Московская область, Домодедовский район)"},
"1":{"id":169703,"name":"Москва","area":48,"telcod":"","latitude":57.448612,"longitude":29.185556,"time_zone":"0","english":"Moscow","rajon":3589,"country":"RU","sound":"M210","level":"0","iso":"","vid":"0","full_name":"Москва (Псковская область, Порховский район)"},
"2":{"id":193458,"name":"Москва","area":61,"telcod":"","latitude":null,"longitude":null,"time_zone":"0","english":"Moscow","rajon":1535,"country":"RU","sound":"M210","level":"0","iso":"","vid":"0","full_name":"Москва (Тверская область, Пеновский район)"},
"3":{"id":217176,"name":"Москва","area":27,"telcod":"","latitude":null,"longitude":null,"time_zone":"0","english":"Moscow","rajon":3164,"country":"RU","sound":"M210","level":"0","iso":"","vid":"0","full_name":"Москва (Кировская область, Верхошижемский район)"},
"4":{"id":462041,"name":"Москва","area":7859,"telcod":"","latitude":null,"longitude":null,"time_zone":"0","english":"Moscow","rajon":"0","country":"KG","sound":"M210","level":"0","iso":"","vid":"0","full_name":"Москва (Киргизия, Баткенская област)"}
}

Вариант запроса для получения готового html кода для вставки на страницу в <Select></Select>

http://htmlweb.ru/geo/api.php?city_name=москва&api_key=API_KEY_из_профиля

Ответ:

<option value='1'>Москва (Московская область, Домодедовский район)</option>
<option value='169703'>Москва (Псковская область, Порховский район)</option>
<option value='193458'>Москва (Тверская область, Пеновский район)</option>
<option value='217176'>Москва (Кировская область, Верхошижемский район)</option>
<option value='462041'>Москва (Киргизия, Баткенская област)</option>

API получения ближайших городов(населенных пунктов) от заданного

Структура API запроса для получения ближайших населенных пунктов:

http://htmlweb.ru/geo/api.php?city_coming=ID_CITY&json&api_key=API_KEY_из_профиля

Например, для Москвы:

http://htmlweb.ru/geo/api.php?city_coming=1&json&api_key=API_KEY_из_профиля

Ответ:

{"0":{"id":837,"name":"Ильпырский","area":24,"telcod":"","latitude":55.755772,"longitude":37.617760,"time_zone":null,"english":"Il'pyrskiy","rajon":1512,"country":"RU","sound":"I416","level":"0","iso":"","vid":"0","distance":"0.008051199154096073","full_name":"Ильпырский (Россия, Камчатская область, Карагинский район)"},
 "1":{"id":5882,"name":"Вилючинск-3","area":24,"telcod":41538,"latitude":55.755772,"longitude":37.617760,"time_zone":null,"english":"Vilyuchinsk-3","rajon":"0","country":"RU","sound":"V422","level":"0","iso":"","vid":"0","distance":"0.008051199154096073","full_name":"Вилючинск-3 (Россия, Камчатская область)"},
 "2":{"id":18812,"name":"Покровка","area":1,"telcod":3459,"latitude":55.759521,"longitude":37.646999,"time_zone":null,"english":"Pokrovka","rajon":2925,"country":"KG","sound":"P261","level":"0","iso":"","vid":"0","distance":"1.8842262410223318","full_name":"Покровка (Киргизия, Московская область, Клинский район)"},
  ....
 "19":{"id":5743,"name":"Вилла Гора","area":25,"telcod":8145623,"latitude":55.779900,"longitude":37.394295,"time_zone":null,"english":"Villa gora","rajon":1303,"country":"RU","sound":"V426","level":"0","iso":"","vid":"0","distance":"14.229374783729542","full_name":"Вилла Гора (Россия, Республика Карелия, Пряжинский район)"},
 "limit":"40"
}

Вариант запроса для получения готового html кода для вставки на страницу:

http://htmlweb.ru/geo/api.php?city_coming=1&api_key=API_KEY_из_профиля

Ответ:

<p>Ближайшие города (населенные пункты) для <span style='font-size:10px;' title='latitude, longitude'>(55,755787, 37,617634)</span>:</p>
<div class='box'>
    <a href="http://htmlweb.ru/geo/country/RU/city/837"><b>Ильпырский</b></a> - <b>0 км </b> <span style='font-size:10px;' title='latitude, longitude'>(55.755772, 37.617760)</span><br>
    <a href="http://htmlweb.ru/geo/country/RU/city/5882"><b>Вилючинск-3</b></a> - <b>0 км </b> <span style='font-size:10px;' title='latitude, longitude'>(55.755772, 37.617760)</span><br>
    <a href="http://htmlweb.ru/geo/country/KG/city/18812"><b>Покровка</b> (Pokrovka)</a> - <b>2 км </b> <span style='font-size:10px;' title='latitude, longitude'>(55.759521, 37.646999)</span><br>
    ....
    <a href="http://htmlweb.ru/geo/country/RU/city/5743"><b>Вилла Гора</b></a> - <b>14 км </b> <span style='font-size:10px;' title='latitude, longitude'>(55.779900, 37.394295)</span><br>
</div>

Дополнительные необязательные параметры:
length=50 - расстояние в пределах которого осуществляется поиск, км
level=1 - только крупнейшие города
level=2 - большие и крупнейшие города
p=N - с какой страницы выдавать список городов
perpage=30 - сколько городов выводить в списке( за каждые 50 населенных пунктов списывается один запрос, подробнее...)

API получения ближайших городов (населенных пунктов) от заданных координат

Структура API запроса для получения ближайших населенных пунктов:

http://htmlweb.ru/geo/api.php?city_coming&latitude=XXX&longitude=YYY&json&api_key=API_KEY_из_профиля

API получения города по GPS - координатам

Структура запроса для получения ближайшего города по GPS-координатам:

http://htmlweb.ru/geo/api.php?city_coming&perpage=1&latitude=XXX&longitude=YYY

Ответ и дополнительные параметры аналогичны примеру API получения ближайших городов(населенных пунктов) от заданного.

API расчета расстояния между городами

Структура API запроса для расчета расстояния между городами:

http://htmlweb.ru/geo/api.php?city1=ID_CITY1&city2=ID_CITY2&json&api_key=API_KEY_из_профиля

Например, для расчета расстояния между Москвой и Ростовом-на-Дону:

http://htmlweb.ru/geo/api.php?city1=1&city2=1711&json&api_key=API_KEY_из_профиля

Ответ:

{"distance":958.881,
"city1":{"id":1,"name":"Москва","area":1,"telcod":"495,499","latitude":55.755787,"longitude":37.617634,"time_zone":4.00,"english":"Moscow","rajon":"0","country":"RU","sound":"M210","level":1,"iso":"","vid":"0","full_name":"Москва (Россия, Московская область)"},
"city2":{"id":1711,"name":"Ростов-на-Дону","area":49,"telcod":863,"latitude":47.233189,"longitude":39.715000,"time_zone":4.00,"english":"Rostov-na-donu","rajon":"0","country":"RU","sound":"R231","level":1,"iso":"","vid":1,"full_name":"Ростов-на-Дону (Россия, Ростовская область)"},
"limit":42}

Вариант запроса для получения готового html кода для вставки на страницу:

http://htmlweb.ru/geo/api.php?city1=1&city2=1711&api_key=API_KEY_из_профиля

Ответ:

<p>Ближайшие города (населенные пункты) для <span style='font-size:10px;' title='latitude, longitude'>(55,755787, 37,617634)</span>:</p>
<br />
<a href="/geo/country/RU/city/1"><b>Москва</b></a>: 37.617634, 55.755787<br />
<a href="/geo/country/RU/city/1711"><b>Ростов-на-Дону</b></a>: 39.715000, 47.233189<br />
Расстояние между <b>Москва</b> и <b>Ростов-на-Дону</b>: <b style='font-size:18px;'>958.881 км </b>

Ограничение

При расчете лимита за один запрос принимается один запрос с выборкой не более 50 записей. Тарификация производится за каждый запрос!

Обратите внимание, по умолчанию выводится с 1-ой по 50-ую записи. Если Вы хотите вывести следующие 50 записей укажите дополнительный параметр:

&p=2

Если Вы хотите выводить не по 50 а другое кол-во укажите параметр:

&perpage=30
или
&perpage=99999
Общие параметры для всех API сервисов
Другие сервисы, доступные по API
.

Популярное:


Содержание: