{"name":"API Геокодера Яндекс Карт","vendor":"Яндекс","industry":"maps","summary":"HTTP-геокодер Яндекс Карт: прямое геокодирование (координаты по адресу или названию объекта) и обратное (адрес по координатам). Сервис учитывает распространённые опечатки и предлагает несколько вариантов; при обратном геокодировании можно ограничить тип топонима — дома, улицы, населённые пункты. Ответ — JSON.","docsUrl":"https://yandex.ru/maps-api/docs/geocoder-api/index.html","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"poluchit-koordinaty-po-adresu","title":"Получить координаты по адресу","summary":"Поставить точку на карте, посчитать расстояние до склада или зону доставки по адресу из формы заказа.","steps":["Получи ключ в Кабинете разработчика (продукт «API Геокодера») — он активируется в течение 15 минут. Ключ передаётся в параметре apikey; держи запросы на сервере или защищай ключ подписью signature.","Запроси координаты: GET /v1 с geocode — адресом, lang = ru_RU, format = json и results = 1, если нужен только лучший вариант.","Координаты — в response.GeoObjectCollection.featureMember[0].GeoObject.Point.pos в порядке «долгота широта» через пробел. Не перепутай порядок при передаче в карты и формулы расстояний.","Проверь точность: GeocoderMetaData.precision = exact значит, что дом найден точно; near, street или other — что адрес распознан частично, стоит уточнить его у покупателя.","Геокодер исправляет опечатки: исправленный запрос — в GeocoderResponseMetaData.fix."],"code":"import requests\n\nr = requests.get(\"https://geocode-maps.yandex.ru/v1/\", params={\n    \"apikey\": \"<ключ>\", \"geocode\": \"Москва, Тверская улица, 7\", \"lang\": \"ru_RU\", \"format\": \"json\", \"results\": 1,\n}).json()\nobj = r[\"response\"][\"GeoObjectCollection\"][\"featureMember\"][0][\"GeoObject\"]\nlon, lat = map(float, obj[\"Point\"][\"pos\"].split())\nprecision = obj[\"metaDataProperty\"][\"GeocoderMetaData\"][\"precision\"]\nprint(lat, lon, precision)","language":"python","methods":["GET /v1"]},{"id":"opredelit-adres-po-koordinatam","title":"Определить адрес по координатам","summary":"Подставить адрес по точке, которую пользователь выбрал на карте или передал из геолокации телефона.","steps":["Запроси адрес: GET /v1 с geocode = «долгота,широта» (по умолчанию порядок именно такой; для «широта,долгота» передай sco = latlong).","Чтобы получить именно дом, а не район или метро, передай kind = house. Другие варианты — street, metro, district, locality.","Полный адрес — в GeocoderMetaData.text, по частям — в Address.Components: пары kind и name от страны до дома. Поле AddressDetails устарело."],"code":"curl -G https://geocode-maps.yandex.ru/v1/ \\\n  -d apikey=<ключ> -d geocode=37.611347,55.760241 -d kind=house -d lang=ru_RU -d format=json -d results=1","language":"bash","methods":["GET /v1"]},{"id":"iskat-adres-tolko-v-svoem-gorode","title":"Искать адрес только в своём городе","summary":"Подсказки и проверка адреса доставки в зоне работы: чтобы «Ленина, 5» нашлось в твоём городе, а не в соседнем.","steps":["Задай область поиска: bbox — углами «долгота1,широта1~долгота2,широта2», или ll (центр) и spn (протяжённость).","Передай rspn = 1, чтобы искать только внутри области; с rspn = 0 область лишь повышает приоритет результатов.","Запроси несколько вариантов: GET /v1 с results до 50 и покажи их пользователю на выбор. Следующие страницы — через skip (кратно results).","Если в geocode переданы координаты, ограничение области не применяется."],"code":"curl -G https://geocode-maps.yandex.ru/v1/ \\\n  -d apikey=<ключ> --data-urlencode 'geocode=Ленина 5' \\\n  -d bbox=49.0,55.7~49.3,55.9 -d rspn=1 -d results=5 -d lang=ru_RU -d format=json","language":"bash","methods":["GET /v1"]}],"baseUrls":[{"label":"Боевой","url":"https://geocode-maps.yandex.ru"}],"auth":{"type":"api_key","description":"Ключ из Кабинета разработчика передаётся в параметре `apikey`; активируется в течение 15 минут после получения. Для защиты ключа от кражи можно подписывать запросы параметром `signature`.","example":"https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=бульвар+Мухаммед+Бин+Рашид+1&format=json"},"methods":[{"id":"GET /v1","title":"Геокодирование","httpMethod":"GET","path":"/v1","description":"Пример обратного геокодирования:\n\nПостраничная выдача (объекты с 11-го по 15-й):\n\nСтруктура ответа (сокращена):","params":[{"name":"apikey","in":"query","type":"string","required":true,"description":"Ключ из Кабинета разработчика"},{"name":"geocode","in":"query","type":"string","required":true,"description":"Адрес (прямое геокодирование) или координаты (обратное)"},{"name":"lang","in":"query","type":"string","required":true,"description":"Язык ответа language_region: ru_RU, uk_UA, be_BY, en_RU, en_US, tr_TR"},{"name":"sco","in":"query","type":"string","required":false,"description":"Порядок координат в geocode: longlat (по умолчанию) или latlong"},{"name":"kind","in":"query","type":"string","required":false,"description":"Вид топонима при обратном геокодировании: house, street, metro, district, locality"},{"name":"rspn","in":"query","type":"boolean","required":false,"description":"Ограничить поиск областью ll/spn или bbox: 0 — нет (по умолчанию), 1 — да"},{"name":"ll","in":"query","type":"string","required":false,"description":"Долгота и широта центра области поиска"},{"name":"spn","in":"query","type":"string","required":false,"description":"Протяжённость области поиска по долготе и широте"},{"name":"bbox","in":"query","type":"string","required":false,"description":"Область поиска углами x1,y1~x2,y2; приоритетнее ll+spn"},{"name":"format","in":"query","type":"string","required":false,"description":"Формат ответа: json"},{"name":"results","in":"query","type":"integer","required":false,"description":"Максимум объектов, по умолчанию 10, не больше 50"},{"name":"skip","in":"query","type":"integer","required":false,"description":"Сколько объектов пропустить; должно делиться на results"},{"name":"uri","in":"query","type":"string","required":false,"description":"ID объекта для получения доп. информации, вместо текста и координат"},{"name":"signature","in":"query","type":"string","required":false,"description":"Подпись запроса"}],"requestExample":"https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=55.270141,25.193445&format=json","responseExample":"https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&results=5&skip=10&format=json","docsUrl":""}],"codeExamples":[],"errors":[{"code":"400","description":"Нет обязательного параметра или неверное значение; подробности в message"},{"code":"403","description":"Неверный apikey (Invalid apikey)"},{"code":"429","description":"Слишком много запросов за короткое время"}],"limits":"","gotchas":["Координаты в ответе (`Point.pos`, `boundedBy.Envelope`) — в порядке «долгота широта», через пробел.","`GeocoderMetaData.precision` показывает точность совпадения номера дома: `exact`, `number`, `near`, `range`, `street`, `other`.","`Address.Components[]` — компоненты адреса парами `kind`/`name` от крупного к мелкому; поле `AddressDetails` устарело.","`GeocoderResponseMetaData.fix` и `suggest` — исправление опечаток в запросе.","Ограничение области (`rspn`, `ll`, `spn`, `bbox`) игнорируется, если в `geocode` переданы координаты.","HTTP-метод в документации отдельно не указан — запрос задаётся URL с параметрами."],"slug":"yandex-geocoder","version":2,"updatedAt":"2026-10-24T17:05:40.807Z","sources":[{"title":"API Геокодера","url":"https://yandex.ru/maps-api/docs/geocoder-api/index.html","kind":"research","addedAt":"2026-10-14T14:51:36.781Z"},{"title":"Формат запроса","url":"https://yandex.ru/maps-api/docs/geocoder-api/request.html","kind":"research","addedAt":"2026-10-14T14:51:36.781Z"},{"title":"Формат ответа","url":"https://yandex.ru/maps-api/docs/geocoder-api/response.html","kind":"research","addedAt":"2026-10-14T14:51:36.781Z"},{"title":"Примеры","url":"https://yandex.ru/maps-api/docs/geocoder-api/examples.html","kind":"research","addedAt":"2026-10-14T14:51:36.781Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-14T14:51:36.781Z"},{"title":"scenarios-yandex-geocoder.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:30.043Z"}],"logoUrl":null}