XML файл для импорта компаний

Материал из Map.BY
(Различия между версиями)
Перейти к: навигация, поиск
(Спецификация XML файла)
(Спецификация XML файла)
Строка 17: Строка 17:
 
** '''RU''' - Русский
 
** '''RU''' - Русский
 
** '''EN''' - Английский
 
** '''EN''' - Английский
 +
|-
 +
|item|| начало описание единицы компании, юридического лица, сети ||
 +
*''id'' - уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например '''100'''
 +
|-
 +
|name||Название организации, юридического лица, сети. Например '''ООО "Васильки INC"'''
 +
|-
 +
|address||Блок адресов компании. При типе компании '''network''' данный блок может повторяться неограниченное количество раз с описанием адресов различных точек сети
 +
|-
 +
|city||Город. Должен быть указан в соответствии с данным о городах сайта map.by. Список всех городов можно получить посредством [[Определение географических координат населенных пунктов]]
 
|}
 
|}
  

Версия 19:17, 11 сентября 2012

Для импорта компании, юридического лица или объектов сетей Вы можите воспользоваться функцией XML импорта данных на сайт map.by. Для этого Вам необходимо подготовить и разместить у себя на хостинге файл XML в соответствии со спецификацией с описанием данных о импортируемой организации, и внести его в нашу систему "Актуализатор".

Спецификация XML файла

Узел Описание Аттрибуты
companies Родительский узел для описания компаний
  • version - указывает версию используемого протокола. На данный момент актуальная версия 1.0
company информация о компании, юридическом лице, сети
  • type - информация о типе компании. Возможны следующие варианты:
    • object - объект на карте, например "Ресторан Павлинка"
    • entity - юридическое лицо, например "ООО Рестораны Павлинка"
    • network - сеть, наприме "ООО Сеть ресторанов Павлинка". Сеть может иметь в себе несколько адресов объектов.
  • lang- Язык предоставленной информации о компании, юр лице, сети. Возможны варианты:
    • RU - Русский
    • EN - Английский
item начало описание единицы компании, юридического лица, сети
  • id - уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например 100
name Название организации, юридического лица, сети. Например ООО "Васильки INC"
address Блок адресов компании. При типе компании network данный блок может повторяться неограниченное количество раз с описанием адресов различных точек сети
city Город. Должен быть указан в соответствии с данным о городах сайта map.by. Список всех городов можно получить посредством Определение географических координат населенных пунктов

Валидация XML файла

Пример файла

<?xml version="1.0" encoding="UTF-8"?>
<companies version="1.0">
	<company type="object" lang="RU">
		<!-- object|entity|network -->
		<item id="0001">
			<name>{NAME}</name>
			<address>
				<city>{CITY}</city>
				<street>{STREET}</street>
				<building>{BUILDING}</building>
				<room>{ROOM}</room>
				<coordinates>
					<lat>53.1122</lat>
					<lon>27.11111</lon>
				</coordinates>
			</address>
			<categories>
				<category>{CATEGORY1}</category>
				<category>{CATEGORY2}</category>
				<category>{CATEGORY3}</category>
			</categories>
			<phones>
				<phone>
					<num>{NUM}</num>
					<description>{DESCRIPTION}</description>
				</phone>
				<phone>
					<num>{NUM2}</num>
					<description>{DESCRIPTION2}</description>
				</phone>
				<fax>
					<num>{NUM}</num>
				</fax>
			</phones>
			<url>{URL}</url>
			<email>{EMAIL}</email>
			<webpages>
				<page>
					<url>{URL}</url>
					<description>{DESCRIPTION}</description>
				</page>
				<page>
					<url>{URL2}</url>
					<description>{DESCRIPTION2}</description>
				</page>
			</webpages>
			<logo>{LOGO_URL}</logo>
			<short_description><![CDATA[ {SHORT_DESCRIPTION} ]]></short_description>
			<description><![CDATA[ {DESCRIPTION} ]]></description>
			<tags>
				<tag>{TAG1}</tag>
				<tag>{TAG2}</tag>
			</tags>
			<attributes>
				<working_hours>
					<day nameofday="1" starting="09:30:00" finish="18:00:00">
						<interrupt starting="14:00:00" finish="15:00:00"/>
					</day>
					<day nameofday="2" starting="09:30:00" finish="18:00:00">
						<interrupt starting="14:00:00" finish="15:00:00"/>
					</day>
					<day nameofday="6" starting="09:30:00" finish="14:00:00"/>
				</working_hours>
			</attributes>
		</item>
	</company>
</companies>
Личные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты