Что такое api

Data format

Data provided by our API contains the following fields.

Service «Geo-IP API»:

ip — checking IP address;
country_code — 2-characters country identifier;
country — name of country in english;
country_rus — name of country in russian;
region — name of region in english;
region_rus —name of regionin russian;
city — name of city in english;
city_rus — name of city in russian;
latitude — latitude;
longitude — longitude;
zip_code — postcode;
time_zone — time zone.

Service «Provider-IP API»:

ip — checking IP address;
name_ripe — provider official name in the Internet Routing Registry (IRR) database;
name_rus — provider name/brand in russian;
site — provider website;
as — provider AS;
ip_range_start — numeral value (iptolong) of the first IP address of the ISP’s network;
ip_range_end — numeral value (iptolong) of the last IP address of the ISP’s network;
route — network;
mask — netmask.

Service «Hosting API»:

name_ripe — hosting provider official name in the Internet Routing Registry (IRR) database;
site — hosting provider website;

Service»MAC-address API»:

company — the name of the company that registered the MAC address block;
address — company full address;
country — 2-characters country identifier according to the standard ISO 3166-1;
private — for an additional fee, suppliers can hide their data. In this case, this flag is set to true, and company, address, and country are set to «private»;
oui — unique organization identifier;
block_size — block size;
date_created — date when the range was allocated;
date_updated — date when the range was last updated;

Способы узнать IP-адрес своего компьютера

Узнать свой IP-адрес можно 3-мя основными способами:

• С помощью онлайн-сервисов, которые отображают IP посетителя;
• С помощью центра управления сетями и соединениями Windows;
• С помощью командной строки CMD.

Запрос в Яндексе

Обращаясь к популярной поисковой системе, можно узнать внешний IP адрес наиболее легко и быстро.

1. Обеспечивается доступ к сети Интернет, набирается следующий запрос в поисковике: «IP».
2. Отдельный виджет – интерактивное окно с предложением от Яндекса – определит IP адрес устройства в сети, с которого работает пользователь.

Определение своего IP онлайн

Далее поисковые системы предлагают множество сервисов. Они позволяют узнать своего провайдера по IP, посредством которого посещается сайт, и множество других полезных сведений вроде отображаемого местонахождения, скорости соединения. Рекомендуются первые показанные результаты, располагающиеся в выдаче выше всех благодаря релевантности запросу и репутации.

1. В поисковой системе вводится запрос «IP», «узнать IP адрес моего компьютера», выбирается предложенный сервис.
2. В большинстве сервисов не нужно выполнять никаких дополнительных команд: на странице, куда будет совершён переход, отобразится искомый IP.

Центр управления сетями и подключениями

Если вариант установления IP онлайн не подходит, посмотреть айпи адрес компьютера можно посредством встроенной панели управления Windows и её отдельных разделов.

1. В системном трее – области уведомлений справа внизу на рабочем столе – по значку сетевого подключения щёлкают правой клавишей мыши. В разных версиях системы, при разных подключениях значок может визуально отличаться.
2. По строке «Центр управления сетями и подключениями (общим доступом)» щёлкают левой кнопкой.
3. Чтобы узнать IP компьютера в локальной сети, нужно нажать в окне действующей сети ссылку «Подключения».
4. В появившемся окне «Состояние» в разделе «Подключение» нужно нажать кнопку «Сведения…».
5. В новом окне «Сведения о сетевом подключении» можно узнать локальный IP адрес компьютера напротив свойства «Адрес IPv4». Это числовая последовательность протокольного адреса, использующегося для подключения в данный момент.

Командная строка

Если прочие способы по тем или иным причинам не подходят, можно узнать IP компьютера через cmd. Command module – это приложение в ОС Windows, позволяющее управлять системой с помощью вводимых на клавиатуре текстовых команд. Более известен этот интерфейс (система ввода данных), как командная строка Windows. К ней можно обращаться как с командами, так и за справочными сведениями о системе, которые будут отображены в минималистичном и доступном виде.

Доступ к командной строке не является очевидной и распространённой операцией, но может быть без труда выполнен любым рядовым пользователем. По инструкции можно быстро узнать свой IP через командную строку.

1. Чтобы посмотреть на IP адрес своего компьютера, нужно набрать на клавиатуре комбинацию клавиш Win+R. Появляется окно «Выполнить», в котором необходимо набрать на латинице трёхбуквенную команду «cmd».Кнопка Win располагается на стандартной клавиатуре рядом с клавишами Ctrl и Alt. Так как она является инструментом обращения к стандартным общим функциям операционной системы, то её название обусловлено названием самой ОС – Windows. В связи с этим для удобства клавиша Win может быть помечена вместо надписи логотипом корпорации – четырьмя цветными искажёнными квадратами в форме окошка.
2. Появляется чёрное окно приложения cmd.exe, в котором нужно набрать в строке, отмеченной мигающим знаком подчёркивания, команду «ipconfig» и нажать Enter.
3. Сведения о конфигурации протокола и действующий IP адрес своего компьютера можно найти в показанной далее сводке в строке «IPv4».

Определить айпи адрес своего компьютера можно несколькими способами посредством вызова командной строки, сведений о подключении из Панели управления или в специализированных онлайн-сервисах. В зависимости от выбранного метода, внутри локальной сети в самом компьютере и в Интернете полученный адрес может отличаться.

Формирование результата поиска

Параметр отвечает за формирование результата поиска. Ниже описаны самые используемые алгоритмы формирования результата. С полным списком алгоритмов можно ознакомиться в описании API.

Поиск с раскрытием

Поиск, при котором категории и организации будут раскрыты до компаний (филиалов организации). Например, при поиске «почта России» в ответе будут все почтовые отделения. Аналогично работает раскрытие категории — при поиске «кафе» в результате будут компании в категории «Кафе / Кондитерские», а не сама категория, которая также является объектом справочника.
Этот алгоритм формирования результата используется по умолчанию и соответствует переданному в запрос параметру .

Поиск в здании

Подходит для поиска организаций в здании, например, в бизнес-центре или торгово-развлекательном центре. Также можно использовать для автодополнения при поиске в здании.
Для изменения алгоритма формирования результата нужно передать в запрос и указать id здания в параметре .

Особенности онлайн-сервиса 2ip.ru

Главное достоинство сервиса заключается в точности полученной пользователем информации. Но плюсы сайта не ограниваются только тонной проверкой, поэтому посетители положительно оценят:

• скорость тестирования на 2ip, позволяющую получить нужные сведения спустя несколько секунд после запуска проверки;
• доступность портала, позволяющую проводить бесплатное тестирование каждому желающему;
• большое количество дополнительных данных о тестируемой сети (например, данные о регионе и провайдере), для получения которых иногда не требуется даже запускать сервис;
• простоту проведения проверки, позволяющую ограничиться несколькими кликами.

Недостатки

Если пользователь рассчитывает просто провести несколько тестов скорости на 2ip, то никаких недостатков он не заметит, а единственным минусом окажется реклама. Но обойтись без рекламных вставок сервис не может, поскольку они являются его основным источником дохода. Если он откажется от них, проверки станут платными.

Если посетитель нуждается в глубокой проверке и использовании всех предусмотренных разработчиками портала функций и инструментов, потребуется регистрация. Собственно, необходимость создавать аккаунт – второй недостаток системы.

Как проверить скорость интернета на 2ip.ru

Чтобы измерить скорость на 2ip, достаточно совершить несколько простейших действий:

1. посетить портал 2ip.ru;
2. нажать большую кнопку, запускающую спидтест;
3. подождать, пока программа проведёт тестирование.

Для повышения точности теста рекомендуется отключить на компьютере все процессы и программы, которые используют часть трафика. Стоит закрыть лишние вкладки браузера, выключить обновления, отменить скачивание файлов, отключить ненужные программы, даже если они работают в фоновом режиме.

Полученные данные

После завершения спидтеста скорости интернета 2ip пользователю станут известны 3 основных показателя:

• скорость загрузки, отвечающая за качество входящих соединений (скачивании файлов, время открытия сайтов, просмотр видео, прослушивание музыки);
• уровень отдачи, актуальный для видеозвонков;
• пинг, который указывает время, нужное для передачи пакета с данными на сервер.

Стоит подчеркнуть, что для получения максимально точной информации текущем подключении рекомендуется провести несколько измерений в разное время суток. Это позволит исключить влияние временных факторов, например, рост нагрузки на сеть в пиковые часы.

Формат ответа на запрос

Ответ на запрос возвращается в формате JSON:

Параметры ответа на запрос

В ответе на запрос по умолчанию передаются параметры:

• — идентификатор объекта;
• — название объекта;
• — тип объекта. Типы объектов определены в описании API.

Дополнительную информацию об объекте можно передать в параметре .
Возможно получение дополнительной информации:

• точка, к которой привязан объект;
• адрес или местоположение объекта и его привязка к административно-территориальным единицам;
• информация о геометрии объекта, визуальный центр геометрии;
• информация о родительской организации, к которой относятся все филиалы компании;
• расписание работы;
• контактная информация;
• связанные с компанией или местом объекты — точки входа, ближайшие остановки и парковки, обслуживающие организации, подъезды в здании и другие;
• подробная информация о парковках — вместимость, стоимость, тип доступа, количество уровней;
• подробная информация о здании — этажность, материал здания.

Перечень дополнительной информации определён в описании API.

Формат запроса

В данном разделе приведён пример запроса

В запросе используются следующие параметры:

• — поиск выполняется по запросу «кафе»;
• — координаты точки, поблизости которой выполняется поиск кафе;
• — ваш ключ API.

Фильтрация результата поиска по типу объекта

Параметр используется в запросе для фильтрации объектов по типу. Поиск будет выполняться только среди объектов указанного в запросе типа.
Наиболее используемый список признаков, по которым возможна фильтрация:

• по местоположению — например, в определённом районе, городе, в заданной области;
• по типу данных в ответе — например, когда нужны только компании или только здания;
• по категории — например, только кафе или только продуктовые магазины;
• по организации — можно получить список всех филиалов одной организации;
• по времени работы — например, только круглосуточно работающие филиалы;
• по наличию или отсутствию данных — например, фотографий, отзывов, рейтинга, сайта, ИНН.

Полный список фильтров и соответствующие им параметры можно изучить на странице описания API.

Сортировка результата поиска

Подключить сортировку результата поиска можно с помощью параметра в запросе.

Результат поиска сортируется по удалённости от местоположения пользователя, рейтингу объекта и другим параметрам. Виды сортировки определены в описании API.

Поиск в области на карте

Объекты можно искать в области на карте. Данный вид поиска позволяет получить релевантные результаты.
Варианты поиска в области на карте:

• геокритерий в текстовом запросе — запрос «Москва кафе»;
• точка, относительно которой выполняется поиск;
• поиск в радиусе;
• поиск в прямоугольной области;
• поиск в произвольной области;
• поиск в городе.

Для поиска объектов в области на карте в запросе передаются координаты точек, в границах которых будут найдены объекты, или идентификатор города, в котором будет выполняться поиск объектов. С подробным описанием полей можно ознакомиться на странице описания API, c примерами использования геоограчений — на соответствующей странице.

Поиск информации об организации

Организацию можно найти по ИНН, номеру телефона, адресу сайта и торговой лицензии. Такой поиск не учитывает местоположение пользователя. Результатом поиска является список организаций. Полное описание всех методов и параметров для поиска можно изучить на странице описания API.