Введение

Многие разработчики используют GeoIP API, чтобы автоматически определять географическое местоположение пользователя по его IP-адресу. С помощью API можно получить данные о стране, регионе, городе и интернет-провайдере пользователя и использовать их для персонализации сайта, аналитики или настройки региональных сервисов. В предыдущей статье мы разобрали, какие преимущества и ограничения имеет бесплатный API геолокации. Теперь рассмотрим пример запроса к GeoIP API и формат ответа в JSON.

---

Как работает GeoIP API

API геолокации работает по простому принципу:

1. сайт отправляет IP-адрес пользователя
2. сервер GeoIP выполняет поиск в базе IP
3. API возвращает результат в формате JSON.

Запрос обычно выполняется через стандартный HTTP или HTTPS.

---

Пример запроса к GeoIP API

Ниже приведён пример простого запроса к сервису геолокации.

GET https://api.example.com/geoip?ip=8.8.8.8

В запросе передаётся IP-адрес, для которого нужно определить геолокацию.

---

Пример ответа API (JSON)

После обработки запроса API возвращает данные в формате JSON.

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "city": "Mountain View",
  "latitude": 37.386,
  "longitude": -122.0838,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC"
}

Такая структура ответа удобна для обработки на стороне сайта или приложения.

---

Что означают параметры ответа

GeoIP API обычно возвращает несколько ключевых параметров.

IP

IP-адрес, для которого был выполнен запрос.

---

Country

Страна, определённая по IP.

---

Country code

Двухбуквенный код страны по стандарту ISO.

---

Region

Регион или область внутри страны.

---

City

Город, связанный с IP-адресом.

---

Latitude и Longitude

Географические координаты предполагаемого местоположения.

---

Timezone

Часовой пояс пользователя.

---

ISP

Интернет-провайдер, которому принадлежит IP-адрес.

---

Пример использования GeoIP API на сайте

После получения ответа API данные можно использовать в коде сайта.

Например:

• показывать пользователю локальную валюту
• автоматически выбирать язык интерфейса
• ограничивать доступ к сервису в определённых странах.

Также геолокация по IP используется для аналитики и оценки географии аудитории.

---

Использование GeoIP API в JavaScript

Пример запроса API с использованием JavaScript:

fetch("https://api.example.com/geoip?ip=8.8.8.8")
  .then(response => response.json())
  .then(data => {
    console.log("Country:", data.country);
    console.log("City:", data.city);
  });

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

---

Где получить GeoIP API

Сегодня существует несколько сервисов, предоставляющих API для определения геолокации IP.

Обычно такие сервисы предлагают:

• REST API
• JSON-ответ
• поддержку IPv4 и IPv6.

Например, сервис GeoIP от WildX

Перед использованием API важно учитывать точность базы IP и стабильность работы сервиса.