Адрес по координатам

Ближайшие к точке дома: например, адрес курьера или пункт на карте, куда нажал человек.

GETPOSThttps://api.adresnitsa.ru/v1/geolocate

Подходит любой ключ: публичный и секретный.

Параметры

Параметр	Тип	Что это
lat	число	Обязательный. Широта, градусы.
lon	число	Обязательный. Долгота, градусы.
radius	1–1000	Радиус поиска в метрах. По умолчанию 100.
count	1–20	Сколько адресов вернуть. По умолчанию 10.
details	true/false	Добавить к каждому адресу все поля (все поля). По умолчанию false.

Пример

Точка у дома 11 на Сухонской улице в Москве, радиус 50 м.

curl

curl -G https://api.adresnitsa.ru/v1/geolocate \
  -H "Authorization: Token ВАШ_КЛЮЧ" \
  -d lat=55.87834 \
  -d lon=37.65367 \
  -d radius=50 \
  -d count=3

JavaScript

const url = new URL("https://api.adresnitsa.ru/v1/geolocate");
url.search = new URLSearchParams({ lat: "55.87834", lon: "37.65367", radius: "50", count: "3" });
const res = await fetch(url, {
  headers: { Authorization: "Token ВАШ_КЛЮЧ" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.adresnitsa.ru/v1/geolocate",
    params={"lat": 55.87834, "lon": 37.65367, "radius": 50, "count": 3},
    headers={"Authorization": "Token ВАШ_КЛЮЧ"},
    timeout=5,
)
data = res.json()

PHP

<?php
$url = "https://api.adresnitsa.ru/v1/geolocate?" . http_build_query([
    "lat" => 55.87834,
    "lon" => 37.65367,
    "radius" => 50,
    "count" => 3,
]);
$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n",
    "ignore_errors" => true,
]]);
$data = json_decode(file_get_contents($url, false, $ctx), true);

Ответ200 OKданные 2026.01.02 v.219

{
  "results": [
    {
      "distanceM": 0.6,
      "address": "г Москва, ул Сухонская, д 11",
      "id": 26847188,
      "qcGeo": 0
    }
  ]
}

Ответ

results — адреса в радиусе, сначала ближайший.
distanceM — расстояние от точки в метрах.
qcGeo — откуда точка адреса: 0 — сам дом, 1 — ближайший дом, 2 — улица.
В радиусе ничего нет — ответ 200 с пустым results.