--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/faq/index.md - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/faq/index.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt # Часто задаваемые вопросы ### Как подключить фиксированную версию JavaScript API? {#load-version} Для этого в [ссылке подключения](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/load.md) необходимо указать номер этой версии, например: ```xml ``` {% note info %} Со временем мы можем отключить устаревшую [минорную версию](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/versions/index.md) JavaScript API. Если вы использовали эту версию в своем проекте, то у вас автоматически подключится последняя версия API. {% endnote %} ### Как вставить карту в блог, если в нем запрещены скрипты? {#how-to-share} Если ваш блогохостинг запрещает использование скриптов, то вставить интерактивную карту с помощью JavaScript API не получится. Для вставки интерактивной карты вы можете воспользоваться [Виджетом Карт](https://yandex.ru/support/maps/concept/get-map-reference.html#ariaid-title3). При добавлении Виджета на сайт карта будет размещена в отдельном iframe. Вы также можете использовать статическое изображение карты. Для получения изображения карты воспользуйтесь [Конструктором карт](https://tech.yandex.ru/maps/tools/constructor/) либо [Static API](https://tech.yandex.ru/maps/staticapi/). ### Я перешел с JavaScript API 2.0 на версию 2.1, но код перестал работать. Есть ли инструкции по переходу? {#change-version} Версии 2.0 и 2.1 являются обратно несовместимыми. Ознакомьтесь с [Руководством по переходу на JavaScript API 2.1](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/upgrade/index.md). ### Можно ли использовать API карт на сайте с CSP? {#using-csp} Можно. Подробнее читайте в документации в разделе [Подключение API при использовании CSP](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/load.md#using-csp). ### Я размещаю на сайте карту с помощью JavaScript API, но карта не отображается. Что я делаю не так? {#showing-map-errors} 1. Убедитесь, что при подключении АПИ вы передаете правильный ключ. Если у вас нет ключа, получите его в [Кабинете разработчика](https://developer.tech.yandex.ru/). 1. Убедитесь, что при создании экземпляра карты вы указали верный идентификатор DOM-элемента. 1. Проверьте, заданы ли размеры контейнера, в котором размещается карта (они должны быть ненулевыми). 1. Карта не отобразится, если на момент ее создания код API еще не был загружен. Чтобы при работе с картой код API был гарантированно загружен, его рекомендуется размещать в функции [ymaps.ready()](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready.md). Подробнее см. в разделе [Готовность API](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/load.md#api-ready). ### Как добавить на карту собственный слой? {#custom-map-layer} См. [пример](https://tech.yandex.ru/maps/jsbox/2.1/custom_map). ### Почему на моем сайте геолокация перестала работать или стала определять неточное положение? {#geolocation} Вероятнее всего ваш сервис расположен на http-домене. Google запретил определение местоположения средствами браузера на не https-доменах. В этом случае в консоли браузера выводится соответствующая информация: [https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-powerful-features-on-insecure-origins](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-powerful-features-on-insecure-origins) ### Я задаю свойства/опции объектам карты, но они не применяются. В чем может быть проблема? {#wrong-options} Возможно, вы неправильно используете систему префиксов при задании свойств или опций. Например, чтобы задать свойства для значка метки, нужно использовать префикс 'icon' (`iconLayout`), чтобы задать свойства для значка кластера, нужно использовать префикс 'clusterIcon' (`clusterIconLayout`). Кроме того, использование префиксов зависит от того, на каком уровне задаются свойства — через сам объект, через его коллекцию или на уровне карты. Подробнее см. [Использование префиксов в названиях опций](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/general.md#option-name). ### Можно ли изменить внешний вид точек маршрута? {#changing-waypoints-view} Можно. Пример в песочнице: [Настройка отображения мультимаршрута](https://tech.yandex.ru/maps/jsbox/2.1/multiroute_view_options). ### Почему при использовании кластеризации метки не отображаются на карте? {#adding-cluster} Возможно, вы добавляете на карту одновременно и кластер, и отдельные метки, входящие в этот кластер. Добавлять нужно только кластер. Подробнее см. [Кластеры](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects.md#clusters). ### Я хочу рассчитать площадь полигона/прямоугольника/круга на геодезической поверхности. Есть ли в API специальный инструмент? {#mapsapi-area} Для вычисления геодезической площади фигур можно воспользоваться внешним модулем: [https://github.com/yandex/mapsapi-area](https://github.com/yandex/mapsapi-area). Модуль может использоваться совместно с API. ### Геокодер возвращает пустой результат или не тот результат, который я хочу увидеть. Что делать в этом случае? {#tech-geocoder-wrong-answ} 1. Если вы используете обратное геокодирование, убедитесь, что в запросе указаны координаты в правильной последовательности. По умолчанию Геокодер принимает координаты в последовательности «долгота, широта». Изменить порядок координат можно в параметре [sco](https://yandex.ru/dev/maps/geocoder/doc/desc/concepts/input_params.html#input_params__param-sco). 2. Убедитесь, что вы указали корректные границы поиска (параметры [bbox](https://yandex.ru/dev/maps/geocoder/doc/desc/concepts/input_params.html#input_params__bbox) или [ll+spn](https://yandex.ru/dev/maps/geocoder/doc/desc/concepts/input_params.html#input_params__param-ll-spn)). Возможно, искомый объект находится за пределами заданной области поиска. 3. Если искомого объекта нет на самой карте Яндекса, вы можете нарисовать его на [Народной карте](https://n.maps.yandex.ru) или сообщить об ошибке на странице [Яндекс Карт](https://yandex.ru/maps). ### При нажатии на кнопку «Открыть в Яндекс Картах» пропадает часть маркеров. Почему? {#tech-many-dots} В такой ситуации на большую карту передается только 10 точек, ближайших к центру карты. Чтобы передать больше точек, используйте карту, созданную в [Конструкторе карт](https://yandex.ru/map-constructor/). ## Поддержка {#support} Если вы не нашли ответ на свой вопрос, вы можете [задать его нам](https://yandex.ru/maps-api/support).