IP2RUSCITY

Определение города России по ip‑адресу

Город
—
Регион
—
IP-адрес
—
Координаты
—

Описание

Продукт представляет собой базу данных ip-адресов и их принадлежность к городам России (включая Республику Крым). Объект города имеет привязку к региону, геокодированные координаты в Google Maps и Яндекс.Карты.

База поставляется в виде JSON-файлов, импортировав которые, Вы получите надежное решение для геолокации Ваших клиентов. Обновление базы происходит раз в месяц.

Ограничения на использование

  1. Вы можете использовать БД в пределах организации в любых целях.
  2. Вы не можете распространять или перепродавать БД.

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 передаются в строке запроса.

Ограничения

  1. Без указания apiKey количество запросов с одного ip не должно превышать 20 в сутки.
  2. С использованием apiKey количество запросов ограничено 5 запросов в секунду и 3000 в час.
  3. Ограничения считаются отдельно для определения города и для определения страны; /my расходует лимит определения страны.

При превышении ограничений сервис выдает ответ 429 «Too Many Requests»; заголовок Retry-After содержит число секунд, через которое можно повторить запрос. На неизвестный apiKey сервис отвечает 401.

Купить

Стоимость

Стоимость платной версии — 4000 руб., включено 2 месяца обновлений.

Подписка на обновления

3 месяца600 руб.
6 месяцев1100 руб.
12 месяцев2000 руб.

Специальное предложение База + 12 месяцев обновлений — 5000 руб.

Способы оплаты

Для покупки базы оплатите необходимую сумму, указав Ваш email в примечании. Данные для доступа к базе будут высланы Вам на email в течение одного рабочего дня.

Контакты

Есть вопросы или предложения? Напишите нам:

— +372 57834763