Skip to main content
Skip table of contents

Карта планов клиента

Карта планов

Отдает все планы в рамках заданных координат Если в области карты, будет слишком много планов, то произойдёт серверная кластеризация

Пермишен для данного запроса - map-index

В запросе, когда планы сгруппированы, есть поле key, которое можно прислать в запросе VMS Client/Карты/Планы/Список планов в поле cluster_key для получения пагинированного списка камер внутри данного кластера

GET /api/v1/map/maps/

Параметры метода

numeric bottom_left_latitude, Координата широты нижней левой точки


numeric bottom_left_longitude, Координата долготы нижней левой точки


numeric top_right_latitude, Координата широты верхней правой точки


numeric top_right_longitude, Координата долготы верхней правой точки


int zoom, Текущий уровень зума на карте

cURL
BASH
curl -k --request POST \
	--url 'https://your-domain/api/v1/map/maps/' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "bottom_left_latitude": "numeric",
    "bottom_left_longitude": "numeric",
    "top_right_latitude": "numeric",
    "top_right_longitude": "numeric",
    "zoom": 0
}'
PHP
PHP
$data = array (
  'bottom_left_latitude' => 'numeric',
  'bottom_left_longitude' => 'numeric',
  'top_right_latitude' => 'numeric',
  'top_right_longitude' => 'numeric',
  'zoom' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'GET',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/v1/map/maps/', false, $context);

Ответы на запрос

200 OK

Успешный ответ с кластеризацией

JSON
{
    "grouped": true,
    "items": [
        {
            "latitude": 52.797159556908035,
            "longitude": -28.424838677853487,
            "count": 3086,
            "key": "u9h"
        },
        {
            "latitude": 42.797159556908035,
            "longitude": -28.424838677853487,
            "count": 7600,
            "key": "u9k"
        },
        {
            "latitude": 32.797159556908035,
            "longitude": -28.424838677853487,
            "count": 3629,
            "key": "u8k"
        }
    ]
}

200 OK

Успешный ответ без кластеризации

JSON
{
  "grouped": false,
  "items": [
    {
      "id": 1,
      "name": "Plan 1",
      "url": "https://vms.local:8000/storage/maps/2024/4/9/36MibYuVSAQjSe7qPj0si2mWbLsq6LclaKJqLi0o.jpg",
      "latitude": 32.797159,
      "longitude": -28.424838
    }
  ]
}

401 Unauthorized

Токен авторизации не передан или не валидный

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.