История посещений геозон

Этот API получает информацию о том, когда объекты посещали определённые геозоны за указанный период времени.

Как получить данные

Метод

GET

Адрес запроса

Для получения данных используйте адрес:  https://<server_address>/api/api.php?

Параметры запроса

  • cmd=ag_geozones — команда API для получения истории геозон
  • start — дата начала периода (Unix timestamp)
  • stop — дата окончания периода (Unix timestamp)
  • imei — идентификатор транспортного средства. Можно указать несколько через запятую
  • node — номер узла, на котором нужно выполнить команду
 

Пример запроса для одного транспортного средства

https://<server_address>/api/api.php?cmd=ag_geozones&start=1606770000&stop=1608584399&imei=865291046424635&node=1
Ответ
{
  "code": 0,
  "msg": "OK",
  "data": [
    {
      "group": "Общие",
      "zonename": "База Голицыно",
      "ts": 1606805707,
      "te": 1606808500
    },
    {
      "group": "Общие",
      "zonename": "База Голицыно",
      "ts": 1606865643,
      "te": 1606868103
    }
  ]
}
 

Пример запроса для нескольких транспортных средств

https://<server_address>/api/api.php?cmd=ag_geozones&start=1606770000&stop=1608584399&imei=865291046424635,867481037184458
Ответ
{
  "code": 0,
  "msg": "OK",
  "data": {
    "865291046424635": [
      {
        "group": "Общие",
        "zonename": "База Голицыно",
        "ts": 1606805707,
        "te": 1606808500
      },
      {
        "group": "Общие",
        "zonename": "База Голицыно",
        "ts": 1606865643,
        "te": 1606868103
      }
    ],
    "867481037184458": [
      {
        "group": "Общие",
        "zonename": "База Голицыно",
        "ts": 1607949101,
        "te": 1607956478
      },
      {
        "group": "Общие",
        "zonename": "База Голицыно",
        "ts": 1608012176,
        "te": 1608041334
      }
    ]
  }
}
В ответ на API-запрос возвращается:
  • code — код результата (0 — успех)
  • msg — сообщение сервера (например, "OK")
  • data — информация о посещениях геозон
  • Если один объект, data — массив посещений
  • Если несколько объектов, data — объект, где ключи — IMEI транспортных средств, а значения — массивы посещений
  • group— группа геозоны
  • zonename— название геозоны
  • ts— время входа в геозону (Unix timestamp)
  • te— время выхода из геозоны (Unix timestamp)