Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

Импорт местоположений

Закладки

Важно! Если вы используете старую схему местоположений, то описание страницы импорта смотрите здесь.

Страница Импорт местоположений (Магазин > Настройки > Местоположения > Импорт местоположений) предназначена для импорта местоположений, а также для быстрой очистки всего списка местоположений.


Импорт местоположений

ПолеОписание
Выбор источника местоположений
Источник местоположенийВыбирается источник загрузки местоположений:
  • с удаленного сервера - при этом необходимо отметить нужные вам страны для загрузки;
  • из файла - следует указать файл с помощью кнопки Добавить файл, а также заранее вручную должны быть созданы необходимые типы местоположений и внешние сервисы.
Выбор дополнительных данных
*Почтовые индексы (ZIP-коды)При отмеченной опции в систему будет добавлен внешний сервис ZIP (если он не был добавлен ранее) и будут загружены почтовые индексы для местоположений.
*Коды Яндекс.МаркетПри отмеченной опции в систему будет добавлен внешний сервис YAMARKET (если он не был добавлен ранее) и будут загружены коды Яндекс.Маркет для местоположений.
*Числовые коды стран (ISO 3166-1)При отмеченной опции для местоположений будут заполнены числовые коды стран в формате ISO 3166-1. Опцию необходимо отметить, если вы планируете работать с международной доставкой, используя службу доставки Почта России (профили «EMS зарубеж» и «Посылка нестандартная зарубеж»).
Выбор параметров импорта местоположений
*Загружать местоположения доУказывается до какого включительно типа местоположений загружать местоположения стран в систему.
*Набор местоположенийВыбирается набор местоположений, который нужно загрузить:
  • стандартный - только крупные регионы и города России;
  • расширенный - полный импорт с учетом мелким городов, сел и т.д.
*Не загружать округаПри отмеченной опции местоположения типа Округ не будут загружаться в систему. Таким образом, местоложения типа Область будут дочерними непосредственно для местоположений типа Страна.
Удалить все существующие местоположенияПри отмеченной опции все существующие местоположения будут удалены.
Длина шага, секундыУказывается длина одного шага загрузки местоположений в секундах.
*Поддерживать структурную целостностьПри отмеченной опции будет поддерживаться структурная целостность местоположений. Таким образом, если некоторое местоположение А уже есть в системе, а затем импортируется более крупное по отношению к нему местоположение Б, то автоматически имеющееся местоположение А будет привязано к новому местоположению Б.
Кнопка Начать импорт
Кнопка служит для запуска процесса импорта местоположений в систему.

* - данные параметры доступны только при загрузке местоположений с сервера.



Очистить список местоположений

Расположенная на закладке кнопка Удаление всех местоположений служит для очистки всей базы местоположений из системы.



Пример файла для загрузки местоположений

Важно! Файл должен быть создан в кодировке UTF-8.

CODE;PARENT_CODE;TYPE_CODE;NAME.RU.NAME;EXT.YAMARKET.0;EXT.ZIP.0
kl00001;;REGION;Калининградская область;10857;
kl00011;kl00001;CITY;Калининград;22;236020
kl00021;kl00001;SUBREGION;Гусевский район;;
kl00022;kl00021;CITY;Гусев;20138;238050
kl00031;kl00001;SUBREGION;Балтийский район;;
kl00032;kl00031;CITY;Приморск;20578;238510
kl00033;kl00031;CITY;Балтийск;10858;238520
kl00041;kl00001;SUBREGION;Зеленоградский район;;
kl00042;kl00041;CITY;Зеленоградск;20139;238326
kl00051;kl00001;SUBREGION;Краснознаменский район;;
kl00052;kl00051;CITY;Краснознаменск;20140;238730
kl00061;kl00001;SUBREGION;Неманский район;;
kl00062;kl00061;CITY;Неман;20141;238710
kl00071;kl00001;SUBREGION;Гвардейский район;;
kl00072;kl00071;CITY;Неман;20136;238210
kl00081;kl00001;SUBREGION;Багратионовский район;;
kl00082;kl00081;CITY;Багратионовск;20135;238420

В первой строке указываются названия колонок. Первые три колонки являются обязательными. Первая колонка - CODE - символьный код местоположения, затем идет колонка PARENT_CODE - символьный код родительского местоположения. Следующая колонка - TYPE_CODE - тип местоположения.

Примечание: необходимые типы местоположений должны быть созданы заранеее.

Следующие колонки - это колонки NAME.LANG.NAME с названием местоположения для языка LANG (где LANG - это идентификатор языка в системе). В файле обязательно должна быть колонка NAME.RU.NAME, а колонки для остальных языков интерфейса задавать не обязательно (названия для других языков будут созданы с применением транслита автоматически).

Затем идут колонки для созданных в системе внешних сервисов - EXT.CODE.N, где CODE - код внешнего сервиса, а N - номер колонки (нумерация начинается с нуля) для значения внешнего сервиса с кодом CODE (для местоположения может быть задано несколько значений каждого внешнего сервиса).

В остальных строках файла указываются значения загружаемых данных.



Смотрите также

Смотрите также



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
Антон Мякишев
Расширенный набор местоположений с точностью до улицы рекомендую грузить по 1-2 округа за раз. Целиком импорт России не проходил ни разу ни на BitrixVM ни на хостингах.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх