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

Формат CSV

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

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

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

Для просмотра примера в 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	Координата по долготе. В качестве разделителя целой и дробной части используется точка.

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

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

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

2. Выложите файл на свой сайт по обновляемой ссылке.

   Данные должны быть доступны по протоколу HTTP или HTTPS.

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

На странице сети перейдите в раздел Филиалы. В блоке Управление филиалами выберите Файл.

Укажите ссылку на подготовленный файл, выберите тип «csv» и нажмите Проверить. Проверка файла может занять несколько часов.

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

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

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

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

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