Обновление данных через CSV-файл

Если в вашей сети более 30 филиалов, обновлять данные в Справочнике можно с помощью CSV-файла.

Формат CSV

Формат CSV ― это текстовый формат, предназначенный для представления табличных данных. Первая строка содержит названия столбцов, а следующие строки ― сами данные. Содержимое столбцов отделяется друг от друга запятой.

Данные в файле должны быть в кодировке UTF-8.

Скачать пример CSV-файла

Примечание.

Данные в примере представлены в кодировке UTF-8.

Для просмотра примера в LibreOffice необходимо сделать импорт текста. При этом выберите кодировку UTF-8, разделитель ― «запятая», разделитель текста ― « "(двойные кавычки)».

Для просмотра примера в Excel сохраненный файл откройте через меню Данные → Получение внешних данных → Из текста. Выберите кодировку UTF-8, разделитель «запятая», ограничитель строк «"(двойные кавычки)».

Описание элементов


Элемент	Описание
`name`	Название филиала. Указывается без кавычек, с учетом регистра. Обязательный элемент.
`country`	Страна. Указывается полностью, без сокращений. Обязательный элемент.
`address`	Полный адрес местонахождения филиала, с точностью до дома. Обязательный элемент.
`address-add`	Дополнение к адресу.
`phone`	Номер телефона с кодом страны и населенного пункта. Если номеров несколько, они отделяются друг от друга точкой с запятой (;). Обязательный элемент.
`rubric-id`	Идентификатор рубрики, к которой относится данный филиал. Если рубрик несколько, они указываются через запятую. Полный список идентификаторов рубрик Примечание. У каждого филиала может быть до трех рубрик, но хотя бы одна из них должна совпадать с рубрикой сети. Обязательный элемент.
`url`	Основной сайт сети. Указывается в нижнем регистре, полностью, включая http:// или https://. Обязательный элемент.
`add-url`	Дополнительный сайт сети (например, ссылки на страницы в социальных сетях).
`working-time`	Часы работы. Выходные, нерабочие дни не указываются. Обязательный элемент.
`lat`	Координата по широте. В качестве разделителя целой и дробной части используется точка.
`lon`	Координата по долготе. В качестве разделителя целой и дробной части используется точка.


Элемент	Описание
`name`	Название филиала. Указывается без кавычек, с учетом регистра. Обязательный элемент.
`country`	Страна. Указывается полностью, без сокращений. Обязательный элемент.
`address`	Полный адрес местонахождения филиала, с точностью до дома. Обязательный элемент.
`address-add`	Дополнение к адресу.
`phone`	Номер телефона с кодом страны и населенного пункта. Если номеров несколько, они отделяются друг от друга точкой с запятой (;). Обязательный элемент.
`rubric-id`	Идентификатор рубрики, к которой относится данный филиал. Если рубрик несколько, они указываются через запятую. Полный список идентификаторов рубрик Примечание. У каждого филиала может быть до трех рубрик, но хотя бы одна из них должна совпадать с рубрикой сети. Обязательный элемент.
`url`	Основной сайт сети. Указывается в нижнем регистре, полностью, включая http:// или https://. Обязательный элемент.
`add-url`	Дополнительный сайт сети (например, ссылки на страницы в социальных сетях).
`working-time`	Часы работы. Выходные, нерабочие дни не указываются. Обязательный элемент.
`lat`	Координата по широте. В качестве разделителя целой и дробной части используется точка.
`lon`	Координата по долготе. В качестве разделителя целой и дробной части используется точка.

Подготовка файла

Чтобы настроить автоматическое ежедневное обновление данных о ваших филиалах:

Подготовьте файл в формате CSV. Данные должны быть в кодировке UTF-8.
Выложите файл на свой сайт по обновляемой ссылке.
Данные должны быть доступны по протоколу FTP, HTTP или HTTPS.

Загрузка файла в интерфейсе

На странице сети в Загрузка филиалов файлом нажмите кнопку Добавить. В открывшемся окне укажите ссылку на подготовленный файл, выберите тип «csv» и нажмите Проверить. Проверка файла может занять несколько минут.

Если проверка прошла успешно, кнопка Результаты проверки будет отмечена зеленым. Нажмите ее и в открывшемся окне проверьте изменения в филиалах. На карте может быть показано до 50 филиалов с изменениями. Нажмите Сохранить. Данные из файла будут загружены в базу Справочника. При большом объеме данных загрузка может занять от нескольких часов до суток.

Если в результате проверки будут обнаружены ошибки, кнопка Результаты проверки будет отмечена красным. Исправьте ошибки и снова отправьте файл на проверку.

Чтобы посмотреть изменения в филиалах, переданных через файл, нажмите История загрузок. Кнопка будет доступна через сутки после первой загрузки.

Данные будут обновляться раз в сутки автоматически, если вы не отключите регулярную загрузку. Для этого установите переключатель около Загрузка филиалов файлом в положение Выкл.

Внимание. При автоматическом обновлении необходимо:

Предоставлять данные обо всех действующих филиалах.
Поддерживать данные в актуальном состоянии.

Для однократного обновления данных сохраните файл в формате CSV или XSLX и передайте с помощью формы. Укажите в сообщении актуальный электронный адрес и телефон вашей организации. Если у нас возникнут вопросы по загруженному файлу, мы свяжемся с вами.

Новые данные появятся на Яндекс.Картах в течение семи дней после загрузки правильно оформленного файла.

Если у вас остались вопросы, напишите нам с помощью формы.