Регистрация Войти
Войти через VK




Поиск по сайту



PHP Поиск



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

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

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

Структура 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

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>

Дополнительные необязательные параметры:
level=1 - только крупнейшие города
level=2 - большие и крупнейшие города

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.dev/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_key - уникальный ключ, указан в вашем личном кабинете.

html или не задано - получить информацию в html формате, удобно для вывода в DIV-блок

json - получить информацию в json формате, удобно для заполнения INPUT-полей или преобразования в массив для дальнейшей обработки на Javascript или PHP.
Для Вашего удобства поддерживается формат JSONP. Вы можете добавить параметр &jsonp=ИМЯ_ФУНКЦИИ:
<script type="application/javascript"
src="http://htmlweb.ru/service/api.php?bic=043469751&json&jsonp=parseResponse"></script>
будет возвращен следующий код:

  parseResponse({"name":"ОАО КБ \"РЕГИОНАЛЬНЫЙ КРЕДИТ\"", "city":"КОСТРОМА", ...., "limit":50});

xml - получить информацию в xml формате, удобно для обращения из PHP

sql[=имя_таблицы] - получить информацию в sql формате. Удобно для вставки информации в базу MySql с помощью phpMyAdmin.

charset - по умолчанию все данные возвращаются в кодировке windows-1251, Для получения любой другой кодировки передайте её в дополнительном, необязательном параметре charset: &charset=utf-8 или любой из ISO-8859-1, ISO-8859-15, utf-8, cp866, cp1251, cp1252, and KOI8-R

fields - какие поля включать в ответ, например:
http://htmlweb.ru/geo/api.php?city=1&sql=pb_city&fields=id,name,english,area,rajon,country

limit - определяет количество оставшихся запросов до конца суток для бесплатных запросов или количество запросов до окончания тарифа при платных. Ограничения на бесплатные запросы и тарификация описана здесь.

Параметры можно передавать как GET, так и POST - запросом.

Запрос можно отправлять как по протоколу http:// так и по https://.

Если передан неверный запрос, возвращается HTTP-код ошибки: "400 Bad Request"


.

Популярное:


Содержание:


Новое за неделю



Сейчас на сайте: 1152