Список из нескольких сотен или тысяч адресов — типичная ситуация для сети магазинов, справочника организаций, службы доставки или любой команды, которая годами вела точки в таблице. Чтобы показать их на карте, нужны координаты каждой точки. Искать их вручную нереально, а у «голого» геокодера есть подвох: он уверенно отвечает даже тогда, когда адрес разобрать невозможно. В этой статье — как загрузить такой список в Karty, как читать результат и что делать с адресами, которые система не смогла определить однозначно. Экраны — из реального личного кабинета.
Что такое массовый геокодинг и зачем он нужен
Геокодинг — перевод текстового адреса в координаты (широту и долготу). Массовый — когда это делается для всего списка за один проход. На выходе вы получаете:
- файл с координатами, который можно отдать в свою CRM, 1С или систему доставки;
- готовый набор точек, который показывается на вашей карте одной строкой кода и редактируется в кабинете без правок страницы.
Раздел называется «Точки на карте» и состоит из трёх вкладок: «Новая загрузка», «Мои наборы точек» и «Очередь уточнения». Ниже — по порядку.
Подготовка списка: пять минут, которые экономят час
Качество результата на 80% определяется качеством входных данных. Прежде чем загружать список, проверьте:
- В каждой строке есть населённый пункт. «Ленина, 1» совпадает с сотнями городов и посёлков. «Барнаул, проспект Ленина, 1» — с одним. Если город хранится в отдельной колонке таблицы, склейте её с улицей.
- Номер дома указан цифрами. Корпуса, литеры и строения лучше писать привычным образом: «д. 12, корп. 3», «12к3». Сервис разбирает типичные сокращения, но чем ближе запись к обычной, тем надёжнее результат.
- Адрес одной строкой, до 200 символов. Лишний текст — этажи, комментарии «вход со двора», телефоны — уберите или вынесите в название точки.
- Дубли можно не удалять. Одинаковые адреса внутри одной загрузки считаются один раз: повторные строки получают тот же ответ без расхода квоты.
- Не больше 10 000 строк за раз. Больше — разбейте на несколько загрузок.
Пример для справочника организацийСуды, школы, поликлиники, отделения — адреса подобных списков часто записаны как «ул. Победы, 5» с указанием района отдельно. Добавьте район или город к адресу до загрузки — доля строк, которые придётся уточнять вручную, заметно снизится.
Шаг 1. Загружаем список
Откройте «Точки на карте» → «Новая загрузка». Вставьте список в поле — по одному адресу на строку, либо загрузите файл CSV или Excel.
Обратите внимание на блок «Так будет распознано»: это защита от самой частой ошибки. Если вы вставили три колонки, а система приняла вторую за адрес, вы увидите это до того, как будет потрачена квота.
Форматы строк
Поддерживаются три формата. Разделитель между полями — точка с запятой, а запятая внутри адреса («улица, город») — нормальная часть адреса, разделителем не считается.
- Только адрес:
проспект Ленина 1, Барнаул. - Название; Адрес:
Судебный участок №1; проспект Ленина 1, Барнаул— название увидит посетитель сайта в окошке над точкой. - ID; Название; Адрес:
42; Судебный участок №1; проспект Ленина 1, Барнаул. Собственный ID нужен в двух случаях: чтобы записать координаты обратно в вашу базу и чтобы потом показывать на странице ровно одну точку из набора (об этом — в статье про карту филиалов).
В Excel и CSV работают те же правила: два столбца «Название, Адрес» либо три — «ID, Название, Адрес». Строка заголовка распознаётся автоматически (в ней обычно нет цифр, которые бывают в адресе), но если сомневаетесь — удалите её.
Шаг 2. Следим за обработкой
После нажатия «Начать поиск координат» открывается таблица результатов, и строки обрабатываются одна за другой. Это нарочно не «залп» запросов: мы идём по списку размеренно, чтобы не перегружать геокодер и не ухудшать скорость для других клиентов. Закладывайте 1–3 секунды на адрес: тысяча адресов обрабатывается за 20–40 минут, шесть тысяч — за несколько часов. Повторяющиеся адреса пролетают мгновенно. Страницу можно закрыть: обработка идёт на сервере, и, вернувшись, вы увидите актуальное состояние.
Квота геокодинга списывается только за адреса, на которые геокодер действительно дал ответ. Если квота закончилась или тариф не оплачен, обработка ставится на паузу с понятной пометкой, а не молча обрывается; после пополнения или оплаты она продолжается с того же места.
Шаг 3. Читаем результат: статусы и точность
Вот как выглядит завершённая обработка небольшого списка. Обратите внимание, что «успех» бывает разным.
| Статус | Что значит | Что делать |
|---|---|---|
| найдено | Адрес однозначно определён. В колонке «Точность» стоит «дом», если найден конкретный дом. | Ничего — точка готова. |
| уточнить | Геокодер нашёл несколько подходящих мест или результат недостаточно уверенный. Например, «улица Ленина, 1» без города даёт церковь на Урале, дом в Казахстане и дом в Нижегородской области. | Выберите вариант из списка, «согласитесь на улицу» или укажите точку на карте. |
| принята улица | Дом найти не удалось, вы согласились оставить точку в центре улицы. | Годится, если точность «до улицы» вас устраивает. |
| указано вручную | Вы сами поставили точку на карте. | Ничего. |
| не найдено | Подходящих вариантов нет. | Проверьте написание, добавьте город и повторите; или укажите точку вручную. |
| пропала из списка | При обновлении набора такой строки в новом списке уже нет. | Решаете вы: оставить точку или исключить. |
Принцип, на котором построена вся логика: система не должна молча подставлять сомнительную точку. Слабый результат лучше показать человеку, чем отправить на карту ошибочную метку. Именно поэтому «уточнить» — полезный статус, а не поломка: это список мест, где нужна ваша проверка.
Шаг 4. Разбираем «уточнить»: три способа
Способ 1. Выбрать вариант из списка
Для каждой сомнительной строки показаны до трёх вариантов с полным адресом: страна, регион, район. Нажмите на нужный — строка станет разрешённой. Это быстрее всего, когда подходящий вариант явно виден.
Способ 2. «Согласиться на улицу»
Если дом не найден, но улица определена верно, можно принять точку на улице. Для справочника «где находится отделение» этого часто достаточно, а для курьерской доставки — нет.
Способ 3. «Указать на карте»
Открывает мини-карту: на ней отмечено место, где предполагал геокодер, и есть поиск по адресу. Кликните в нужную точку и нажмите «Подтвердить».
Очередь уточнения: когда загрузок много
Нерешённые строки из всех ваших загрузок собираются на отдельной вкладке. Можно закрыть страницу, вернуться на следующий день и продолжить: ничего не потеряется.
Шаг 5. Сохраняем набор и забираем результат
Когда все строки разобраны (или вы решили оставить часть без решения), задайте название и нажмите «Сохранить набор». В набор попадают найденные точки, принятые варианты и точки, указанные вручную. Кабинет сразу показывает готовый атрибут для вставки на сайт.
data-karty-points="…" (идентификатор набора) и эквивалент для JavaScript map.loadPoints('…').Кнопка «Скачать результат» выгружает таблицу в CSV в кодировке UTF-8 с BOM, поэтому Excel открывает кириллицу без «кракозябр». Столбцы: id, название, адрес, lat, lon, точность, статус. Именно по столбцу id вы сможете записать координаты обратно в свою базу.
Лимит набора зависит от тарифаВ сохранённом наборе может быть: 100 точек на «Базовом», 1 000 на «Старте», 10 000 на «Бизнесе» и 100 000 на «Масштабе». Если список длиннее лимита, нужен тариф выше. Геокодинг считается отдельно: на «Базовом» это 1 500 адресов за 30 дней, на «Старте» — 8 000, на «Бизнесе» — 40 000.
Как обновлять набор, не платя за одно и то же дважды
Списки живут: открылись новые точки, закрылись старые, у части поменялся адрес. Не создавайте набор заново — в «Мои наборы точек» нажмите «Обновить» и загрузите свежий список. Система сравнивает его со старым по ID: строки без изменений в адресе не тратят квоту, изменившиеся геокодируются заново, а исчезнувшие помечаются «пропала из списка» — по ним вы решаете сами. Поэтому свой ID (формат «ID; Название; Адрес») стоит задавать всегда, когда список планируется обновлять.
Как повысить долю адресов, найденных автоматически
На аккуратных данных автоматически определяется большинство адресов, а остаток — это нестандартные записи и неоднозначные названия. Что действительно помогает:
- Единый формат. Если в одной таблице «г. Барнаул, ул. Ленина 5», «Барнаул Ленина проспект д5» и «Ленина 5/Барнаул», разберётся не всё. Приведите записи к одному шаблону формулами Excel.
- Город отдельно, но не потерян. Склейте город и улицу в одну строку.
- Сельские адреса. Для посёлков и сёл указывайте район: «Алтайский край, Целинный район, с. Целинное, ул. Советская, 10». Улицы с одинаковыми названиями в соседних сёлах — главный источник ошибочных точек.
- Нестандартные названия. «Бизнес-центр “Меркурий”» геокодер не найдёт как здание по названию; нужен адрес.
- Проверьте результат на карте. Откройте набор на карте и убедитесь, что нет точек далеко от нужного региона. Выбросы сразу видны — их правят в «Мои наборы точек».
Частые вопросы
Сколько адресов можно загрузить за один раз?
До 10 000 строк в одной загрузке, каждый адрес — до 200 символов. Длинные списки разбивают на несколько загрузок.
Из каких файлов можно загрузить адреса?
Из текста в поле формы, файла CSV или Excel. Допустимы три формата строки: только адрес, «Название; Адрес» и «ID; Название; Адрес».
Что значит статус «уточнить»?
Геокодер нашёл несколько подходящих мест либо результат недостаточно уверенный, например, адрес без города. Вам нужно выбрать вариант из списка, согласиться на улицу или указать точку на карте.
Сколько стоит массовый геокодинг?
Каждый уникальный адрес тратит одну единицу квоты геокодинга: 1 500 за 30 дней на тарифе «Базовый», 8 000 на «Старте», 40 000 на «Бизнесе», 150 000 на «Масштабе». Повторяющиеся адреса внутри одной загрузки не списываются повторно.
Можно ли скачать результат в Excel?
Да, кнопка «Скачать результат» выгружает CSV с колонками id, название, адрес, lat, lon, точность и статус в кодировке UTF-8 с BOM — Excel открывает его без искажения кириллицы.
Как обновить набор, если часть адресов изменилась?
В разделе «Мои наборы точек» нажмите «Обновить» и загрузите новую версию списка. Строки сравниваются по ID: неизменившиеся адреса не тратят квоту, изменившиеся определяются заново, исчезнувшие помечаются как «пропала из списка».
