Конфигурация

Конфигурация пакета производится при его подключении, например, в main.ts/app.ts и пр. файлах для Vue в аргументах createYmaps/createYmapsVue2, или nuxt.config.ts по ключу yandexMaps для Nuxt.

Доступные настройки

apikey

Передаётся в скрипт подключения Карт. Обязательный для запуска параметр.

Ключ, полученный в Кабинете Разработчика.

Примечание

Ключ будет активирован в течение 15 минут после получения.

JS API 3.0 работает только с ключами, у которых заполнено поле "Ограничение по HTTP Referer". Подробнее об ограничениях

lang

Локаль. Передаётся в скрипт подключения Карт. Задается в виде lang=language_region, где:

• language — двузначный код языка. Указывается в формате ISO 639-1.
• region — двузначный код страны. Указывается в формате ISO 3166-1. Подробнее про локализацию

По умолчанию: ru_RU

servicesApikeys

Объект, передаётся в ymaps3.getDefaultConfig().setApikeys(...) сразу после инициализации Карт. В частности, позволяет использовать ymaps3.route и ymaps3.suggest.

Принимает ключи с токенами из Кабинета разработчика.

Список ключей: интерфейс Apikeys.

Будьте внимательны

ymaps3.getDefaultConfig().setApikeys не работает после того, как был смонтирован компонент <yandex-map> и/или подключена карта.

Воспринимайте эту конфигурацию как самый надёжный способ задать эти ключи.

version

Передаётся в скрипт подключения Карт. По умолчанию: v3

domain

Домен скрипта. По умолчанию: https://api-maps.yandex.ru

Из домена и скрипта формируется адрес вида ${domain}/${version}/?params, т.е. по умолчанию будет https://api-maps.yandex.ru/v3/?params

strictMode

В строгом режиме JS API проверяет входные данные. Например, если на карту вы добавите объект, не являющийся наследником YMapEntity, JS API вам об этом сообщит. С выключенным строгим режимом JS API такую проверку не сделает, и ваш код может работать неправильно.

По умолчанию false.

initializeOn

Позволяет вам задать, когда инициализировать скрипт Яндекса. Доступные опции:

• onPluginInit: загрузит скрипт, как только Карты будут инициализированы (createYmaps/createYmapsVue2 в Vue/Astro, или же автоматически в Nuxt)
• onComponentMount (значение по умолчанию): загрузит скрипт при загрузке первого компонента. Режим представляет собой автоматический lazy-load скрипта и является значением по умолчанию
• never: загрузит скрипт только когда вы вызовете initYmaps. Учтите: в таком варианте, если вы не вызовете где-либо initYmaps до запуска компонента, компонент упадёт с ошибкой

importModules

Массив.

Позволяет загрузить модули Карт глобально при загрузке скрипта. Обычно модули грузятся в lazy-режиме автоматически, по требованию.

Например, модуль @yandex/controls-extra загрузится только при использовании YMapOpenMapsButton - и так далее.

Если вы хотите грузить модули сразу, то при желании, можно указать эти модули, и они будут загружены при инициализации Карт:

app.use(createYmaps({
  apikey: 'your-api-key',
  importModules: ['@yandex/ymaps3-controls@0.0.1'],
}));

importModules принимает всё то же, что принимает ymaps3.import, а именно:

• Пакеты JS API
• Модули JS API

mapsScriptWaitDuration

Время в миллисекундах, которое библиотека будет ожидать до инициализации скрипта Яндекса.

По умолчанию: true (5000мс). Чтобы полностью отключить это поведение, и ждать вечно, передайте false.

mapsRenderWaitDuration

Время в миллисекундах, которое библиотека будет ожидать до отрисовки внутренних компонентов.

По умолчанию: true (5000мс). Чтобы полностью отключить это поведение, и ждать вечно, передайте false.

Рекомендация

Не советуем отключать это поведение целиком, так как, по сути, при любой внутренней ошибке карта продолжит ждать и не выдаст exception.

Доступ к конфигурации

Вы можете получить доступ к конфигурации следующим способом:

import { VueYandexMaps } from 'vue-yandex-maps';

console.log(VueYandexMaps.settings.value) //ref

Там же в VueYandexMaps есть доступ к информации о загрузке скрипта (loadStatus, loadError, isLoaded).

При желании, VueYandexMaps.settings можно даже изменять, но это не проверялось - меняйте VueYandexMaps.settings.value на свой страх и риск и только если уверены в том, что по другому никак.