Определение страны по api

API получения местонахождения по номеру телефона:
страны и города

Форма получения информации по номеру телефона здесь

Большинство API функций сервиса htmlweb.ru совершенно бесплатны. Идентификация нужна для исключения злоупотреблений и позволяет разделить количество запросов от разных пользователей. Ограничения на бесплатные запросы и тарификация описана здесь.

Для идентификации используется API_KEY из_профиля. API_KEY может быть передан как GET так и POST запросом.
Не размещайте ключ API_KEY в открытом доступе и в javascript. Он фактически заменяет ваши логин пароль и дает возможность использовать весь функционал нашего сайта от вашего аккаунта, включая платные функции.

Ключи выбора формата:

Для указания кодирования ответа в нужном вам формате добавьте в запрос параметр html или json или xml, например:

При возврате в формате JSON возврашается заголовок header(‘Access-Control-Allow-Origin: *’) — разрешающий кроссдоменные запросы.

Ключ выбора кодировки charset=:

1. windows-1251 по умолчанию всё отдается в кодировке utf-8
2. utf-8 unicode — кодировка UTF-8. Пример: charset=utf-8
3. а также другие: koi-8, ISO-8859-1, ISO-8859-15, cp866, cp1252, KOI8-R

fields — какие поля включать в ответ, например:
http://htmlweb.ru/geo/api.php?telcod=НОМЕР_ТЕЛЕФОНА&sql=pb_city&fields=id,name,english,area,rajon,country

Если Вам нужен другой формат или другая кодировка, а также обо всех найденных проблемах и пожеланиях сообщайте нам.

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

Структура API запроса для получения информации по номеру телефона в json-формате:

Дополнительно возвращается несколько признаков:

• mobile — Мобильный телефон
• sip — IP телефония
• free — Бесплатный, оплачивает владелец номера
• sputnik — Спутниковый телефон, высокая стоимость
• payment — Высокая дополнительная стоимость

Пример для получения информации в html-формате с Вашим API_KEY:

Краткий (short) html-ответ:

Краткий (short) html-ответ для мобильного телефона:

Краткий (short) json-ответ:

Если Вы хотите сразу сделать платный запрос к оператору для получения информации об абоненте, добавьте в запрос параметр hlr. Например:

Вы получите информацию из базы о привязке абонента и будет отправлен HLR-запрос оператору. Для отправки только HLR-запроса используйте следующий вызов:

Ответ от оператора получите через callback, указанный в вашем профиле или в https://htmlweb.ru/sendsms/#История

Пример запроса на PHP:

HLR-запрос информации об абоненте

Вы можете отправить специальный запрос оператору для получения информации об абоненте, так называемый HLR-запрос. HLR (Home Location Register) — это база данных, которая содержит подробную информацию о каждом абоненте мобильных сетей GSM-операторов. Стоимость одного HLR-запроса составляет 45 копеек. В ответ вы получите следующую информацию:

В ответ на запрос информации от абоненте, оператор возвращает следующую информацию:

• imsi — Уникальный код IMSI SIM-карты абонента. В случае смены сим-карты этот номер меняется. Некоторые операторы, например Yota, возвращают некорректный номер.
• msc — Номер сервис-центра оператора, в сети которого находится абонент.
• mcc — Числовой код страны абонента.
• mnc — Числовой код оператора абонента.
• cn — Название страны регистрации абонента.
• net — Название оператора регистрации абонента.
• rcn — Название роуминговой страны абонента при нахождении в чужой сети.
• rnet — Название роумингового оператора абонента при нахождении в чужой сети.

С помощью данного запроса Вы можете определить существование и доступность абонента, отследить замену СИМ-карты, определить в домашней стране находится абонент или в роуминге. Банки по номеру симки определяют, что человек не менял сим-карту и ему можно отправлять кодовые СМС. Этот запрос чаще всего используется для чистки базы абонентов, чтобы удалить уже несуществующие из списка рассылок. Чтобы определить в сети или нет (ON Line) сейчас абонент, существует PING-запрос. Но его стоимость равна стоимости СМС по прямым каналам.

Российские операторы Мегафон и Yota блокируют HLR-запросы информации о своих абонентах.

API запрос для получения HLR-информации:
https://htmlweb.ru/json/sms/hlr/79185558077?api_key=API_KEY_из_профиля
Ответ:

Ответ на этот запрос поступает через некоторое время. Вы можете получить его с помощью Callback вызова адреса, указанного у вас в профиле или вызвать этот запрос ещё раз через некоторое время.

Источник

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Входные параметры:

country — страна. Может быть задана кодом или названием

area — регион, если передан, то выводятся только населенные пункты этого региона

rajon — район, если передан, то выводятся только населенные пункты этого района

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

p, perpage — с какой страницы и сколько на странице

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

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

В кратком формате:

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

или в старом формате:

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

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

Получение полного списка районов населенного пункта (города)

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

Входные параметры:

• city — код города

Пример для Ростова-на-Дону:

Для поиска города по части названия удобно использовать поиск. Пример для Ростова-на-Дону:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Получить названия населенных пунктов, областей, регионов на разных языках, переименования и синонимы

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

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

Поиск по названию в странах, областях, районах, больших городах

Структура API запроса для поиска:

• search — Страна или ISO код страны или название столицы или город в стране

• tbl = country | area | rajon | city — искать только в странах, областях, районах, городах
• country — искать только в указанной стране
• capital2obj — заменить в выборке поле capital на объект, содержащий подробную информацию о столице, иначе возвращается только код столицы. Спишется +1 запрос
• area2obj — заменить в выборке поле area на объект, содержащий подробную информацию о регионе, иначе возвращается только код региона.

Кроме стандартного набора форматов вывода (json, xml, api), поддерживает формат html — возвращает список ссылок в html-формате. Для этого добавьте в запрос параметр &html, например: https://htmlweb.ru/api/geo/search/Москва?html .

• country — список стран
• area — список регионов
• rajon — список районов
• city — список населенных пунктов

Ограничение: возвращается не более 50 позиций в каждом элементе выборки

Ограничение

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

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

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

Источник

API геолокации по IP

Быстрый ответ и актуальные данные

Бесплатно для небольших проектов. Наш API бесплатен для 10,000 запросов в месяц (идентификация по IP и Referer)

Простая интеграция, информация об IP адресе может предоставляться в формате JSON, XML или Newline

Наш сервис местоположения по IP в режиме реального времени используют тысячи разработчиков по всему миру

• Например:
• Apps
• Ваш IP
• 8.8.8.8
• 2c0f:fb50:4003::

Почему тысячи разработчиков выбирают наш API?

Мы стремимся предложить самый быстрый и многофункциональный API геолокации по IP.

Быстро

Серверы ipwhois.io распространены по всему миру для обеспечения скорости, надежности и безопасности. Используя GeoDNS мы направляем запросы на ближайший и самый быстрый узел, что обеспечивает быстрый ответ в любой точке мира.

Мощно и просто

Мы предоставляем простой в использовании и при этом очень функциональный API интерфейс. Интегрируйте наш API геолокации уже сейчас, не нужно регистрироваться и вводить свои данные. Это займет несколько минут.

Точные данные

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

Мультиязычный ответ

Наш IP API Stack поддерживает ответ на нескольких языках, включая английский, немецкий, русский, японский, французский, китайский, испанский и португальский.

Бесплатно для начинающих вебмастеров

Вы можете использовать наш сервис бесплатно до 10,000 запросов в месяц. Выберите тарифный план который подойдет Вашему проекту.

Безопасно

Все данные, отправляемые и обрабатываемые нашими серверами (за исключением бесплатного тарифа), защищены с помощью 256-битного шифрования SSL (HTTPS).

Персонализируйте контент в зависимости от геолокации с помощью нашего API

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

Местоположение

С помощью персонализации контента в зависимости от местоположения посетителя Вы можете улучшить поведенческие факторы на 70%. Используя наш API геолокации по IP Вы сможете перенаправлять посетителей на версию сайта на их языке, грамотно настроить рекламный таргетинг, автоматически заполнять поля форм с названием страны, города, телефонного кода, валюты и т.д. Обнаружить и предотвратить мошенничество, зная фактическое местоположение ваших пользователей и сравнивая его с предоставленным платежным адресом.

Часовой пояс

Обработка нескольких часовых поясов является беспокойной и сложной задачей для каждого разработчика. Мы сделаем это за Вас, предоставив API часового пояса. Он возвращает информацию об имени этого временного пояса, смещении времени от UTC и летнего времени. Показывайте время в своих проектах в привычном для посетителя формате.

Валюта

Просто отображая цены только в местной валюте, можно повысить коэффициент конверсии до 40%. Именно по этому мы создали наш сервис с учетом этой возможности, он позволит вам узнать название местной денежной единицы, ISO код и символ валюты, а так же текущий курс по отношению к доллару США, благодаря этому Вы сможете автоматически конвертировать цены в зависимости от местоположения.

Как IP-геолокация помогла нашим клиентам?

Нам доверяют десятки тысяч разработчиков и тысячи компаний по всему миру

«Благодаря IP-геолокации наших посетителей, используя API от ipwhois.io, мы рассчитываем приблизительные даты и стоимость доставки непосредственно на сайте, в зависимости от региона. Мы пользуемся сервисом около года, за это время продажи заметно выросли.»

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

«Мы перепробовали десятки сервисов геолокации IP, но остановили свой выбор на ipwhois.io. В первую очередь из-за точности данных и скорости ответа, а так же очень порадовала ценовая политика. Мы нашли тот REST API который отвечает всем современным требованиям.»

Часто задаваемые вопросы об IPWHOIS API

Посмотрите наиболее распространенные вопросы, которые люди задают о ipwhois.io.

Для чего нужен ваш API?

Вы можете использовать ipwhois.io, чтобы отфильтровать трафик, настроить контент в зависимости от местоположения посетителя, отобразить полные названия стран, выполнить автозаполнение форм и многое другое.

Как часто обновляются ваша информация об IP?

Наша база данных обновляется практически в режиме реального времени. Благодаря нейросети интегрированной с несколькими каналами (RIPE, APNIC, ARIN, AFRINIC и другими), доставляющими IP-данные в реальном времени.

Нужен ли ключ доступа для бесплатного плана?

Нет. Бесплатный тариф не требует ключа. Вы можете сразу начинать тестировать API, без лишних регистраций, мы ценим Ваше время.

Сколько запросов я могу сделать?

Вам бесплатно предоставляется до 10,000 запросов в месяц. Смотрите наши цены, если вам нужно больше.

Каково среднее время отклика?

Благодаря мощным серверам на нескольких континентах и ​​высоко оптимизированному программному обеспечению мы достигаем реального отклика до 90 миллисекунд в большинстве частей мира.

Могу ли я использовать это на моем коммерческом сайте?

В настоящее время мы не разрешаем коммерческое использование бесплатного плана. Пожалуйста, ознакомьтесь с нашим профессиональным сервисом для доступа к SSL, расширенным возможностям и коммерческой поддержки.

Перейти на профессиональный план

Техническая поддержка, SSL и коммерческое использование

Источник