Перейти к основному содержимому

Определение местоположения по IP-адресу

/ip2geo— точка вызова сервиса определения местоположения по IP-адресу.

Запрос

Обязательные параметры запроса

Имя поляФорматОписаниеПример
api_keyhex-stringДоступ к сервисам.fa749bace6d8a3b1....

Дополнительные параметры запроса

Имя поляФорматОписаниеПример
qstringТело поискового запроса, содержащее IP-адрес протокола IPv4 в десятичном представлении.
По умолчанию, если в запросе не указан искомый IP-адрес, будет автоматически определён и использован IP-адрес клиента с которого осуществляется запрос.
192.168.1.1
lang2-символьный код языкаЯзык ответа на одном из доступных языков.
По умолчанию на языке региона, в котором найден объект.
lang=en

Ответ

Имя поляФорматОписаниеПример
geoidobjectВнутренний гео-ID.
"geo_id": "546"
addressstringНайденный адрес объекта.
"address": "Россия, Москва"
bboxlistГраницы местонахождения найденного объекта для позиционирования на карте.
"bbox": [
``37.326228,
``55.491308,
``37.967428,
``55.957772
]
isocode2charДвухбуквенный код страны согласно ISO 3166-1 alpha-2.
"isocode": "RU"
typestringТип объекта
"type": "locality"
refhex

ID найденного объекта — можно использовать для получения дополнительной информации в сервисе Геокодер.

предупреждение

ID объекта не является стабильным и может со временем изменяться.

"ref": "1000000C4D63818"
pinlistКоординаты найденного объекта (долгота и широта).
"pin": [
37.538851,
55.796731
]

Пример

Запрос

https://geo.rustore.ru/api/ip2geo?api_key=<YOUR_API_KEY>&q=46.138.195.192

Ответ

{
"request": "/ip2geo?q=46.138.195.192&api_key",
"results": [
{
"address": "Россия, Москва",
"bbox": [
37.326228,
55.491308,
37.967428,
55.957772
],
"geo_id": 5506,
"isocode": "RU",
"pin": [
37.617494,
55.750446
],
"ref": "030000000026FCFD",
"type": "city"
}
]
}