Определение города России по ip‑адресу
- Город
- —
- Регион
- —
- IP-адрес
- —
- Координаты
- —
Описание
Продукт представляет собой базу данных ip-адресов и их принадлежность к городам России (включая Республику Крым). Объект города имеет привязку к региону, геокодированные координаты в Google Maps и Яндекс.Карты.
База поставляется в виде JSON-файлов, импортировав которые, Вы получите надежное решение для геолокации Ваших клиентов. Обновление базы происходит раз в месяц.
Ограничения на использование
- Вы можете использовать БД в пределах организации в любых целях.
- Вы не можете распространять или перепродавать БД.
API
Для удобства, при небольшом объеме запросов, сервис Ip2RusCity предоставляет REST API для определения города по ip.
URL для обращения
https://ip2ruscity.com/v1/ip2city
Метод — POST.
Параметры
| Параметр | Описание | Пример |
|---|---|---|
ip обязателен |
Ip-адрес для геокодирования в виде строки или числа (unsigned int) | 149.126.170.1 |
apiKey |
API-ключ | Ключ, полученный при подписке |
callback |
Параметр для оформления ответа в виде JSONP | При вызове с callback=parseResponse в ответе будет
parseResponse({…}); |
Пример запроса
curl -d 'ip=149.126.170.1' https://ip2ruscity.com/v1/ip2city
Ответ
{
ip: "149.126.170.1",
city_id: 1,
city_name: "Москва",
region_id: 77,
region_name: "Москва",
g_lat: 55.755826,
g_lng: 37.6173,
y_lat: 55.755814,
y_lng: 37.617635
}
ip — адрес, по которому выполнен поиск.
g_lat, g_lng — широта и долгота города по Google Maps.
y_lat, y_lng — широта и долгота города по Yandex Maps.
Страна по ip
Определяет страну по данным пяти региональных интернет-регистраторов (RIPE NCC, ARIN, APNIC, LACNIC, AFRINIC) для IPv4 и IPv6. Это страна, где зарегистрирован владелец сети, а не обязательно страна, где она используется.
https://ip2ruscity.com/v1/ip2country
Метод — POST, параметры те же, что у /v1/ip2city; ip
может быть и IPv6-адресом.
curl -d 'ip=149.126.170.1' https://ip2ruscity.com/v1/ip2country
{
ip: "149.126.170.1",
country_iso2: "RU",
country_iso3: "RUS",
country_name_en: "Russia",
country_name_ru: "Россия",
g_lat: 61.52401,
g_lng: 105.318756,
y_lat: null,
y_lng: null
}
country_iso2, country_iso3 — коды страны по ISO 3166-1.
Для сетей, зарегистрированных на регион, а не на страну, бывают коды
EU (Европейский союз) и AP (Азиатско-Тихоокеанский регион);
country_iso3 у них null.
g_lat, g_lng и y_lat, y_lng —
центр страны по Google Maps и Yandex Maps; null, если координат нет.
Если страна не найдена, все поля, кроме ip, равны null.
Свой адрес
https://ip2ruscity.com/my
Метод — GET. Отвечает про адрес, с которого пришёл запрос: поля
/v1/ip2country и ещё ip2city — ответ
/v1/ip2city, если адрес в России, иначе null.
Параметры apiKey и callback передаются в строке запроса.
Ограничения
- Без указания
apiKeyколичество запросов с одного ip не должно превышать 20 в сутки. - С использованием
apiKeyколичество запросов ограничено 5 запросов в секунду и 3000 в час. - Ограничения считаются отдельно для определения города и для определения
страны;
/myрасходует лимит определения страны.
При превышении ограничений сервис выдает ответ 429 «Too Many Requests»; заголовок
Retry-After содержит число секунд, через которое можно повторить запрос.
На неизвестный apiKey сервис отвечает 401.
Купить
Стоимость
Стоимость платной версии — 4000 руб., включено 2 месяца обновлений.
Подписка на обновления
| 3 месяца | 600 руб. |
|---|---|
| 6 месяцев | 1100 руб. |
| 12 месяцев | 2000 руб. |
Специальное предложение База + 12 месяцев обновлений — 5000 руб.
Способы оплаты
Для покупки базы оплатите необходимую сумму, указав Ваш email в примечании. Данные для доступа к базе будут высланы Вам на email в течение одного рабочего дня.
