Узнавайте, где машина и что с ней, прямо в чате
Подключите StarLine к ИИ-агенту: устройства, GPS-координаты, состояние машины и OBD. Агент покажет, где автомобиль, проверит охрану и заведёт двигатель.
Как агент работает с StarLine
Агент ходит в API StarLine и начинает с аккаунта: читает профиль пользователя, забирает список устройств и уже по каждому устройству поднимает данные и состояние — координаты и скорость с GPS-модуля, охрану, двери и зажигание, уровень топлива, напряжение аккумулятора и температуру двигателя из OBD-диагностики, историю событий и сработавших тревог. Из этого собираются сводки по поездкам за день и по параметрам, которые просели за неделю.
Телематика показывает не машину, а последний пакет, который комплекс успел отправить: в подземном паркинге или при слабой связи данные замирают. Поэтому агент всегда называет время последнего обновления рядом с координатами и не выдаёт вчерашнюю точку за текущую. По той же причине он различает состояние охраны, снятое с комплекса, и команду, которую вы только что отправили: пока не пришёл свежий пакет, это ещё не факт.
Дистанционные команды — постановка на охрану, прогрев двигателя — это действие с настоящим автомобилем, поэтому агент выполняет их только после вашего явного подтверждения в чате и называет устройство, к которому обращается. После команды он перечитывает состояние комплекса и говорит, применилась она или нет. Всё остальное — координаты, диагностика, история поездок — идёт на чтение.
Сессию коннектор поднимает сам: приложение подписывает запрос, аккаунт его подтверждает, и дальше агент работает по выданному токену, продлевая его при истечении. Опрос он ведёт по расписанию или по вашему запросу и укладывается в тысячу обращений в сутки, поэтому состояние машины не дёргается каждую минуту, а история поездок собирается пачкой за период. Про данные, которых комплекс не прислал — датчик не установлен или пропала связь, — агент говорит прямо, а не подставляет ноль.
Сценарии интеграции
Где сейчас машина
Агент покажет координаты, скорость и время последнего обновления с GPS-модуля комплекса по каждому устройству в аккаунте.
Состояние и диагностика
Агент проверит охрану, двери и зажигание, уровень топлива, напряжение АКБ и температуру двигателя по данным OBD.
Дистанционные команды
Агент выполнит команды комплекса — постановку на охрану или прогрев двигателя — после вашего подтверждения в чате.
Сводка по поездкам
Агент соберёт сводку по расписанию: поездки за день, сработавшие тревоги и параметры, которые просели за неделю.
Куда ездила машина вчера
Агент поднимет трек за день по точкам GPS и покажет маршрут, остановки с их длительностью и пробег — вместо листания карты в приложении.
Все машины в одном ответе
Агент пройдёт по устройствам аккаунта и сведёт их в один список: где стоит каждая машина, стоит ли на охране, сколько топлива и когда пришёл последний пакет.
Примеры: StarLine
На охране, стоит на Ленинском 78, данные обновились 4 минуты назад.
- Напряжение АКБ 11,9 В — за неделю просело с 12,6, стоит проверить
- Топливо 34%, температура двигателя −7 °C
- Тревог за сутки не было, двери и капот закрыты
Ассистент может ошибаться — проверяйте его работу
За вчера 6 поездок и 84 км пробега, первый запуск в 7:40, последняя остановка в 19:15.
- Дольше всего машина стояла на Профсоюзной — 2 часа 40 минут с заглушенным двигателем
- Два прогрева по 12 минут, оба утром до выезда
Трек собран по точкам GPS за сутки: окно у API не больше 24 часов и не чаще одного запроса в 10 минут на устройство, поэтому длинный период я собираю по дням. Между точками бывают разрывы — в подземном паркинге комплекс молчит, и маршрут там достраивается прямой.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Аккаунт StarLine ID, в списке устройств которого числится машина
- Русский язык интерфейса кабинета — иначе раздел не появится
- Лимит физлица — 1000 запросов в сутки
- 1
Войдите в my.starline.ru
Нужен аккаунт StarLine ID, в списке устройств которого виден комплекс: ключи открывают только его машины. Логин и пароль понадобятся дальше.
- 2
Отправьте заявку в «Разработчикам»
Раздел виден только при русском языке интерфейса. Опишите в заявке цели использования API — без описания её не рассматривают. Одобрение придёт письмом.
- 3
Создайте приложение и возьмите ключи
После письма об одобрении вернитесь в «Разработчикам» → «Создать приложение» и заполните форму. На карточке появятся AppId и Secret.
Частые вопросы
Четырьмя значениями: AppId и Secret приложения, созданного в my.starline.ru → «Разработчикам», плюс логин и пароль аккаунта StarLine ID, в списке устройств которого числится машина. Раздел виден только при русском языке интерфейса, одобрение приходит письмом.
Список устройств аккаунта, GPS-координаты и треки, состояние охраны и датчиков, показатели OBD-диагностики и историю событий комплекса.
Да, коннектор умеет дистанционные команды — например, прогрев двигателя или постановку на охрану. Такие действия агент выполняет только после вашего явного подтверждения.
Физлицу StarLine отдаёт 1000 запросов в сутки, поэтому непрерывный трекинг секунда в секунду не выйдет: агент опрашивает состояние по расписанию или по вашему запросу.