> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/configuration/maps-and-gis/custom-maps.md).

# Пользовательские карты

Добавляйте пользовательские слои карт в Navixy из серверов тайлов или SVG-файлов. Используйте их для картографии ограниченных зон или собственных маршрутов, недоступных у стандартных поставщиков карт.

Вы можете добавлять собственные пользовательские слои карты на платформу Navixy, что может быть особенно полезно для мониторинга транспорта в ограниченных зонах, которые размыты или не отображаются на общедоступных картах, либо для добавления пользовательских маршрутов, которых нет на других картах (например, морских маршрутов).

Существует два типа слоев, которые можно добавить в Navixy:

* Слой с тайлового сервера
* Слой из SVG-файла

## Добавление тайлового сервера как пользовательского слоя карты

После того как тайловый сервер запущен и картографические данные загружены, вы можете легко добавить новые слои карты в интерфейс Navixy. Вам потребуется включить соответствующий плагин для внешней картографии и указать URL вашего тайлового сервера. Вы также можете ограничить доступ к новому слою карты для определенных учетных записей пользователей.

После активации плагина новый слой появится в списке доступных слоев в веб-интерфейсе пользователя и/или мобильных приложениях. Пользователи смогут выбирать каждый слой отдельно (режим замещения) или объединять несколько слоев вместе (режим наложения).

У приложения есть два параметра:

* %name — имя приложения
* %link\_to\_the\_tiles *–* Внешняя ссылка на тайлы

{% hint style="info" %}
Если вы используете HTTPS-соединение, важно, чтобы ссылка на приложение также была HTTPS. В противном случае вы можете столкнуться с ошибкой смешанного контента.
{% endhint %}

После того как у вас будут необходимые данные, вам нужно лишь добавить строку в базу данных MySQL. Слои карты можно добавить для всего сервиса (то есть учетной записи Dealer PaaS) или только для отдельных пользователей.

### Включение слоя для всего сервиса (для всех учетных записей пользователей)

Чтобы добавить новый слой карты во весь сервис Navixy, используйте следующий запрос и укажите параметры, выделенные жирным шрифтом:

{% code overflow="wrap" %}

```
INSERT INTO google.plugins2dealers (dealer_id, plugin_id, parameters) VALUES (1, 50, '{"layers":[{"name":"%name","tiles":["%link_to_the_tiles"]}]}');
```

{% endcode %}

### Включение слоя только для выбранных учетных записей пользователей

При добавлении слоя карты для конкретного пользователя в запрос необходимо включить новый параметр (%user\_id). Этот параметр следует заменить идентификатором пользователя, которому должен быть добавлен слой карты. Если слой нужно добавить нескольким пользователям, для каждого пользователя необходимо отправить отдельный запрос.

```
INSERT INTO google.plugins2users (user_id, plugin_id, parameters) VALUES (%user_id, 50, '{"Слои":[{"name":"%name","tiles":["%link_to_the_tiles"]}]}');
```

## Добавление SVG-файла в качестве пользовательского слоя карты

Платформа Navixy позволяет добавлять SVG-файлы в качестве слоя карты, что может быть особенно полезно для отображения контуров труднодоступных зон, таких как шахты или строительные площадки.

При добавлении пользовательского слоя карты на платформу Navixy для приложения необходимо настроить следующие три параметра:

* %name: название слоя карты
* %link\_to\_the\_layer: внешняя ссылка на слой
* %lat1, %lng1, %lat2, %lng2: координаты любых противоположных углов слоя

{% hint style="danger" %}
Если вы используете HTTPS-соединение для платформы Navixy, важно убедиться, что все ссылки на внешние приложения или ресурсы тоже используют HTTPS. В противном случае вы можете столкнуться с ошибкой смешанного содержимого.
{% endhint %}

### Включение слоя SVG для всего сервиса (для всех учетных записей пользователей)

{% code overflow="wrap" %}

```
INSERT INTO google.plugins2dealers (dealer_id, plugin_id, parameters) VALUES (1, 83, '{"layers":[{ "name": "%name","url":"%link_to_the_layer","bounds":[{"lat":%lat1,"lng":%lng1},{"lat":%lat2,"lng":%lng2}]}]}');
```

{% endcode %}

### Включение слоя SVG только для выбранных учетных записей пользователей

Чтобы добавить слой карты для конкретного пользователя в Navixy, необходимо включить в запрос новый параметр (%user\_id). Этот параметр следует заменить идентификатором пользователя, для которого предназначен слой карты. Если слой карты необходимо добавить нескольким пользователям, для каждого пользователя необходимо выполнить отдельный запрос.

{% code overflow="wrap" %}

```
INSERT INTO google.plugins2users (user_id, plugin_id, parameters) VALUES (%user_id, 83, '{"Слои":[{ "name": "%name","url":"%link_to_the_layer","bounds":[{"lat":%lat1,"lng":%lng1},{"lat":%lat2,"lng":%lng2}]}]}');
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/configuration/maps-and-gis/custom-maps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.