XML файл для импорта событий

Материал из Map.BY
(Различия между версиями)
Перейти к: навигация, поиск
Строка 16: Строка 16:
 
*''id''- уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например '''100'''
 
*''id''- уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например '''100'''
 
|-
 
|-
|item|| начало описание единицы компании, юридического лица, сети ||
+
!onetime!!Блок описания события, не повторяющегося в будущем
*''id'' - уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например '''100'''
+
 
|-
 
|-
|name||Название организации, юридического лица, сети. Например '''ООО "Васильки INC"'''
+
|start_date||Дата начала события. Дата должна быть указана в формате ISO 8601
 
|-
 
|-
!address!!Блок адресов компании. При типе компании '''network''' данный блок может повторяться неограниченное количество раз с описанием адресов различных точек сети
+
|end_date||Дата окончания события. Дата должна быть указана в формате ISO 8601
|-
+
|city||Город. Должен быть указан в соответствии с данным о городах сайта map.by. Список всех городов можно получить посредством [[Определение географических координат населенных пунктов]]
+
|-
+
|street||Название улицы. Должно быть указано в соответствии с данными о улицах городов сайта map.by. Список всех улиц можно получить посредством [[Определение географических координат улиц]]
+
 
|-
 
|-
 
|building||Номер строения. Если номер строения имеет корпус, то его необходимо так же указать в этом узле, например ''168к3'' означает строение номер 168 корпус 3
 
|building||Номер строения. Если номер строения имеет корпус, то его необходимо так же указать в этом узле, например ''168к3'' означает строение номер 168 корпус 3

Версия 14:47, 15 октября 2012

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

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

Узел Описание Аттрибуты
events Родительский узел для описания списка событий
  • version - указывает версию используемого протокола. На данный момент актуальная версия 1.0
event информация о событии
  • type - информация о типе события. Возможны следующие варианты:
    • onetime - Событие, не повторяющееся в будущем.
    • recurent - Повторяющееся по определенным правилам событие
    • multidate - Повторяющееся по определенным датам событие
  • id- уникальный идентификатор компании в Вашем каталоге. Служит для однозначной идентификации компании. Рекомендуем использовать целые числа, Например 100
onetime Блок описания события, не повторяющегося в будущем
start_date Дата начала события. Дата должна быть указана в формате ISO 8601
end_date Дата окончания события. Дата должна быть указана в формате ISO 8601
building Номер строения. Если номер строения имеет корпус, то его необходимо так же указать в этом узле, например 168к3 означает строение номер 168 корпус 3
room Номер комнаты (офиса). Если таковой отсутствует, или их нескольно - рекомендуется оставлять данный узел пустым
coordinates Блок географических координат
lat Географическая широта. Должна быть представлена в виде дробного числа с разделителем целой части - знаком точка (.) например 55.123144
lon Географическая долгота. Должна быть представлена в виде дробного числа с разделителем целой части - знаком точка (.) например 25.324224
categories Блок описания разделов каталога, к которому может быть отнесена компания, юридическое лицо, сеть
category Текстовое наименование раздела, к которому может быть отнесена компания. Каждая категоря должна быть перечислина отдельным узлом. Допускается до 3 разелов каталога для одной компании, организации, сети. Например: Аптеки
phones Блок описания телефонов
phone Блок описания номера телефона
num Номер телефона в международном формате. Допускаются только цифры, Например: 375171234567
description Описание номера телефона, например Городской или Отдел продаж или Velcom
fax Номер факса в международном формате. Допускаются только цифры, Например: 375171234567
url Адрес сайта в интернете. Рекомендуеся использовать префикс http:// например http://www.map.by
email Адрес контактной электронной почты организации, юридического лица, сети, например: sales@map.by
webpages Список Web страниц организации, юридического лица или сети
page Начало блока описания сети Web страниц организации
url Адрес страницы организации, юридического лица или сети в интернете. Рекомендуеся использовать префикс http:// Например http://vk.com/mapby
description Описание страницы. Например Наше сообщество ВКонтакте
logo URL адрес логотипа организации, юридического лица или сети. Допустимые форматы: GIF, JPEG, PNG. Рекомендуется указывать полный адрес к логотипу, например http://www.map.by/images/logo.png
short_description Краткое описание деятельности компании. Разрешено использовать HTML разметку. Ограничение - 255 символов. Разрешенные теги: <soucrce lang="html4strict">
</source>

Внимание! Данные для полного текста должны быть заключены в контейнер CDATA

description Полное описание деятельности. Разрешено использовать HTML разметку. Разрещенные теги: <soucrce lang="html4strict">
</source>

Внимание! Данные для полного текста должны быть заключены в контейнер CDATA

tags Блок описание тегов компании
tag Тег (слово, словосочетание) которое может кратко характериховать компанию. Каждая тег должн быть перечислин отдельным узлом. Допускается до 5 тегов для одной компании, организации, сети. Например: Лекарства
attributes Блок описание аттрибутов компании
working_hours Блок, описывающий время работы компании.
day Описание дня Аттрибуты:
  • nameofday - номер дня недели. ПН считается 1, ВТ - 2 и т.д.
  • starting - время начала работы. Время в формате 24H, ЧЧ:MM:CC
  • finish - время окончания работы. Время в формате 24H, ЧЧ:MM:CC
interrupt Описание перерывов в работе Аттрибуты:
  • starting - время начала перерыва. Время в формате 24H, ЧЧ:MM:CC
  • finish - время окончания перерыва. Время в формате 24H, ЧЧ:MM:CC

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

Для Валидации подготовленных Вами данных вы можите использовать готовую схему валидации данных, расположенную по адресу: http://www.map.by/repo/sample.xsd. Обращаем ваше внимание что Валидация не является гарантом логической правильности введенных данных. Валидация означает что данные составлены в соответствии со XML спецификацией и не содержит синтаксических ошибок.


Пример файла

<?xml version="1.0"?>
<events version="1.0">
	<event id="{INT}" type="onetime">
		<onetime>
			<start_date>2012-07-16T19:00+01:00</start_date> <!-- ISO 8601 -->
			<end_date>2012-07-17T19:00+01:00</end_date>
		</onetime>
 
		<name>{NAME}</name>
		<image>http://www.imageaddress.com/image.jpg</image>
		<url>http://www.mysite.com/event-123</url>
		<description>
		<![CDATA[
		Здесь может быть любое описание, а так же HTML разметка.
		 ]]>
		</description>
 
		<address>
				<city>{CITY}</city>
				<street>{STREET}</street>
				<building>{BUILDING}</building>
				<room>{ROOM}</room>
				<coordinates>
					<lat>53.1122</lat>
					<lon>27.11111</lon>
				</coordinates>
		</address>
	</event>
 
	<event id="{INT}" type="recurent">
		<recurent>
			<recurency>
				<preiod>daily|weekly|monthly|yearly</period>
				<hm>12:00, 18:00</hm>
				<dow>1,2,3</dow>
				<day>12,21</day>
				<month>2,6</month>
			</recurency>
		</recurent>
		<name>{NAME}</name>
		<image>http://www.imageaddress.com/image.jpg</image>
		<url>http://www.mysite.com/event-123</url>
		<description>
		<![CDATA[
			Здесь может быть любое описание, а так же HTML разметка.
		 ]]>
		</description>
 
		<address>
				<city>{CITY}</city>
				<street>{STREET}</street>
				<building>{BUILDING}</building>
				<room>{ROOM}</room>
				<coordinates>
					<lat>53.1122</lat>
					<lon>27.11111</lon>
				</coordinates>
		</address>
	</event>
 
	<event id="{INT}" type="multidate">
		<multidate>
			<date>
				<start_date>2012-07-16T19:00+01:00</start_date>
				<end_date>2012-07-17T19:00+01:00</end_date>
			</date>
			<date>
				<start_date>2012-07-26T19:00+01:00</start_date>
				<end_date>2012-07-27T19:00+01:00</end_date>
			</date>			
		</multidate>
 
		<name>{NAME}</name>
		<image>http://www.imageaddress.com/image.jpg</image>
		<url>http://www.mysite.com/event-123</url>
		<description>
		<![CDATA[
			Здесь может быть любое описание, а так же HTML разметка.
		 ]]>
		</description>
 
		<address>
				<city>{CITY}</city>
				<street>{STREET}</street>
				<building>{BUILDING}</building>
				<room>{ROOM}</room>
				<coordinates>
					<lat>53.1122</lat>
					<lon>27.11111</lon>
				</coordinates>
		</address>
	</event>
 
</events>
Личные инструменты
Пространства имён

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