Для владельцев

А давайте дружить? Для владельцев АЗС, АГЗС и т.п. мы сделали специальный механизм по обмену информацией. На данный момент, информацию можно передавать путем передачи XML файла специального формата и обычного CSV файла. Интересно?

Как это работает?

Вы подготавлевайте XML или CSV файл определенного формата, выкладываете у себя на сайте, передаете нам ссылку для загрузки этого файла - а дальше мы добавляем и обновляем информацию о переданных станциях.

Выберите формат файла

Формат XML-файла

Для настройки передачи данных:

  1. Подготовьте файл в формате XML (загрузить пример файла).
  2. Выложите файл на свой сайт по обновляемой ссылке.

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

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

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

Передаваемые данные должны соответствовать спецификации формата XML.

Общие требования

  1. XML-файл должен быть создан в кодировке UTF-8.
  2. Каждая станция должена быть представлена в отдельной карточке: для каждой станции должен быть указан свой идентификатор с отдельным набором элементов.
  3. В данных не должно быть HTML-элементов. В стандарте XML недопустимы символы с ASCII-кодами в диапазоне значений от 0 до 31 в текстовых полях. Исключением являются значения 9, 10, 13 — табуляция, перевод строки, возврат каретки. Также этот стандарт строго требует заменять в тексте некоторые символы: & на &.

Пример XML-файла

<?xml version="1.0" encoding="UTF-8"?> 
<companies xmlns:xi="http://www.w3.org/2001/XInclude" version="2.1">
    <company>
        <company-id>0101425</company-id>
        <name>АЗС №425</name>
        <address>Москва, ул. Волхонка, д.14, стр. 10</address>
        <coordinates>
                <lon>34.427524546763365</lon> 
                <lat>53.219950313883814</lat>
        </coordinates>
        <phone>+7 (495) 123-45-67</phone>
        <phone>+7 (495) 765-43-21</phone>
        <email>info@site.ru</email>
        <url>http://www.site.ru</url>
        <add-url>https://vk.com/name</add-url>
        <working-time>Круглосуточно</working-time>
        <actualization-date>2016-06-10 17:16:18</actualization-date>
        <photos>
            <photo url="http://site.ru/azs/425.jpg" alt="Экстерьер" />
            <photo url="http://site.ru/azs/425_1.jpg" alt="Интерьер" />
        </photos>
        <features>
            <feature name="Интернет" value="true"/>
            <feature name="Магазин" value=" true"/>
            <feature name="Кафе" value="true"/>
            <feature name="СТО" value="false"/>
        </features>
        <fuels>
            <fuel name="Аи-95" value="36.50" currency="RUB"/>
            <fuel name="Аи-92" value="34.50" currency="RUB"/>
            <fuel name="Дт улучшенный" value="true"/>
        </fuels>
    </company>
</companies>

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

Наименование

Описание

Пример

Обязательные элементы
company-id Уникальный идентификатор филиала (присваивается владельцем сети). Может содержать цифры и латинские буквы. <company-id>425</company-id>
name Название филиала. Указывается без кавычек, с учетом регистра. <name>АЗС №425</name>
address Адрес станции (одной строкой). В свободной форме. <address> Москва, ул. Волхонка, д.14, стр. 10</address>
coordinates Составной элемент. Координаты по широте и долготе. <coordinates><lon>34.427524546763365</lon> <lat>53.219950313883814</lat></coordinates>
lon Координата по долготе. В качестве разделителя целой и дробной части используется точка. <lon>37.604099</lon>
lat Координата по широте. В качестве разделителя целой и дробной части используется точка. <lat>55.745922</lat>
Дополнительные элементы
status Статус станции. Варианты значений:
  • open — работает;
  • closed — закрыта;
  • temporarily — временно не работает.
<status>open</status>
email Адрес электронной почты (если адресов несколько, то каждый указывается в отдельном элементе). <email>info@site.ru</email>
url Основной сайт сети. Указывается в нижнем регистре, полностью, включая http:// или https://. <url>http://www.site.ru</url>
add-url Дополнительный сайт сети (например, ссылки на страницы в социальных сетях). <add-url>https://vk.com/name</add-url>
working-time Часы работы в свободной форме <working-time>Круглосуточно</working-time>
actualization-date Дата актуализации. Соответствует времени последней актуализации данных. Используется для того, чтобы не скачивалась информация, полученная при предыдущей проверке. Содержимое может быть указано в формате:
  • ГГГГ-ММ-ДД ЧЧ:ММ:СС;
<actualization-date>2016-06-10 17:16:18</actualization-date>
photos Составной элемент. Список фотографий. <photos><photo url="http://site.ru/azs/425.jpg" alt="Экстерьер" /><photo url="http://site.ru/azs/425_1.jpg" alt="Интерьер" /></photos>
photo Ссылка на изображение. (если адресов несколько, то каждый указывается в отдельном элементе). Элемент photo может содержать следующие атрибуты:
  • alt — текстовое описание фотографии в свободной форме;
<photo url="http://site.ru/azs/425.jpg" alt="Экстерьер" />
features Составной элемент. Список услуг. <features><feature name="Мойка" value="true"/><feature name="Магазин" value=" true"/><feature name="Кафе" value="true"/></features>
feature Услуга на станции. Элемент feature должен содержать следующие атрибуты: name — текстовое наименование услуги в свободной форме; value — true или false (Да или Нет) Если есть автомойка: <feature name="Мойка" value="true"/><
fuels Составной элемент. Список видов топлива. <fuels><fuel name="Аи-95" value="36.50" currency=”RUB”/> <fuel name="Аи-92" value="34.50" currency=”RUB”/> <fuel name="Дт улучшенный" value="true"/></fuels>
fuel Вид топлива на станции со стоимостью. Элемент fuel должен содержать следующие атрибуты: name — текстовое наименование топлива в свободной форме; value — стоимость топлива. В качестве разделителя целой и дробной части используется точка. currency — код валюты по стандарту ISO 4217 Если в продаже есть Аи-95 и его стоимость: <fuel name="Аи-95" value="36.50" currency=”RUB”/>
fuel Вид топлива на станции без стоимости. Элемент fuel должен содержать следующие атрибуты: name — текстовое наименование топлива в свободной форме; value — true или false (Да или Нет) Если в продаже есть Аи-95, но нет стоимости: <fuel name="Аи-95" value="true"/>

Форма отправки

Формат CSV-файла

Для настройки передачи данных:

  1. Подготовьте файл в формате CSV разделители — точка с запятой (загрузить пример файла).
  2. Выложите файл на свой сайт по обновляемой ссылке.

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

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

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

Форма отправки

И как дополнительное преимущество - уже через несколько часов Ваши заправки буду на Яндекс.Карты!

Вопросы? Всегда welcome@roadera.com


Спонсоры и партнеры
НафтаИмпексГрупп Таргет Петролеум Яндекс Карты