Глобальные свойства и методы объекта relgl. Устанавливаются до инициализации карты.
| Свойство / Метод | Тип | Описание |
|---|---|---|
relgl.accessToken |
string | Токен доступа к картам |
relgl.baseApiUrl |
string | Базовый URL API для получения тайлов, стилей, спрайтов и глифов |
relgl.workerCount |
number | Количество веб-воркеров (по умолчанию: половина ядер CPU, не более 6). Задавать до инициализации карты |
relgl.maxParallelImageRequests |
number | Максимальное количество параллельных загрузок изображений (по умолчанию: 16) |
relgl.version |
string | Версия текущей сборки |
relgl.supported() |
function | Проверяет, поддерживает ли браузер REL GL JS |
relgl.setRTLTextPlugin(url, callback, lazy) |
function | Устанавливает плагин RTL для поддержки арабского и еврейского языков |
relgl.getRTLTextPluginStatus() |
function | Возвращает статус RTL-плагина: unavailable, loading, loaded, error |
relgl.clearStorage(callback?) |
function | Очищает кеш тайлов в cacheStorage |
relgl.prewarm() |
function | Инициализирует ресурсы заранее для ускорения загрузки карт |
relgl.clearPrewarmedResources() |
function | Очищает ресурсы, созданные prewarm() |
Пример:
relgl.accessToken = 'your_api_key';
relgl.baseApiUrl = 'https://api.blink-maps.com';
relgl.workerCount = 2;
relgl.maxParallelImageRequests = 10;
if (!relgl.supported()) {
alert('Ваш браузер не поддерживает REL GL JS');
}
console.log(relgl.version); // => 1.2.3
// RTL-плагин для арабского/еврейского текста
relgl.setRTLTextPlugin(pluginUrl, function(error) {
if (error) {
console.log('Ошибка загрузки RTL-плагина', error);
}
}, true);
// Оптимизация для SPA — предварительная инициализация ресурсов
relgl.prewarm();
// Очистка ресурсов при окончательном уходе со страницы с картами
relgl.clearPrewarmedResources();
Параметры анимации, используемые в методах Map#panBy, Map#easeTo и других.
| Параметр | Тип | Описание |
|---|---|---|
duration |
number | Продолжительность анимации в миллисекундах |
easing |
function | Функция плавности: принимает время в диапазоне 0..1, возвращает число (0 — начало, 1 — конец) |
offset |
PointLike | Смещение центра относительно центра контейнера карты в конце анимации |
animate |
boolean | Если false, анимации будут отключены |
essential |
boolean | Если true, анимация не затрагивается настройкой prefers-reduced-motion |
Параметры камеры, используемые в методах Map#jumpTo, Map#easeTo, Map#flyTo.
| Параметр | Тип | Описание |
|---|---|---|
center |
LngLatLike | Центр карты |
zoom |
number | Уровень масштаба |
bearing |
number | Пеленг в градусах (направление компаса "вверх"). Например, 90 — восток вверху |
pitch |
number | Наклон в градусах (0–60). 0 — взгляд вертикально вниз, 60 — к горизонту |
around |
LngLatLike | Если задан zoom, определяет точку, вокруг которой центрируется масштаб |
padding |
PaddingOptions | Отступы viewport'а для смещения точки схода |
Параметры отступов, используемые в методах Map#fitBounds, Map#fitScreenCoordinates, Map#setPadding. Все значения — неотрицательные целые числа в пикселях.
| Параметр | Тип | Описание |
|---|---|---|
top |
number | Отступ сверху |
bottom |
number | Отступ снизу |
left |
number | Отступ слева |
right |
number | Отступ справа |
var bbox = [[-79, 43], [-73, 45]];
// Разные отступы со всех сторон
map.fitBounds(bbox, {
padding: { top: 10, bottom: 25, left: 15, right: 5 }
});
// Одинаковые отступы со всех сторон
map.fitBounds(bbox, {
padding: 20
});