Спецификация
Слой yandex-tile
предназначен для отображения на интерактивной карте тайловых слоёв Яндекс-карт,
однако то, как организована работа слоя несколько отличается от работы классических тайловых слоев.
Дело в том, что Яндекс не дает прямого доступа к тайловым сервисам Яндекс-карт, их использование допускается только через официальное API Яндекс-карт.
Слой yandex-tile
подгружает API Яндекс-карт, добавляет внутрь интерактивной карты полноценный экземпляр Яндекс-карты с заданными настройками, и затем на протяжении всей работы с интерактивной картой просто проксирует её события (смещение карты, изменение zoom-а, и т.п.) на вложенную Яндекс-карту.
Ember-компонент слоя и его свойства
Ember-компонет слоя располагается в специальном аддоне ember-flexberry-gis-yandex по пути ember-flexberry-gis-yandex/addon/components/layers/tile-yandex-layer и поддерживает следующий набор свойств, которые соответствуют одноименным с ними настройкам в объекте settings
в модели слоя:
Наименование свойства | Тип свойства | Описание |
---|---|---|
type |
String |
Тип желаемого тайлового слоя Яндекс-карты, который может принимать значения ‘map’ (обычная рисованная карта), ‘satellite (спутниковые снимки)’, ‘hybrid’ (гибридная карта совмещающая рисованные дороги и прочие объекты с подложкой из спутниковых снимков), и по умолчанию имеет значение ‘map’ |
jsApiUrl |
String |
URL для загрузки API Яндекс-карт, по умолчаню имеет значение ‘https://api-maps.yandex.ru/2.1/’ |
detectLanguageAutomatically |
Boolean |
Флаг: показывает нужно ли автоматически определять язык приложения, чтобы использовать его в качестве параметра ‘lang’ в URL-е, при загрузке API Яндекс-карт. По умолчанию имет занчение true . Если проставить ему значение false , тогде потребуется явно указывать один из поддерживаемых языков (‘ru_RU’, ‘ru_UA’, ‘en_US’, ‘en_RU’, ‘uk_UA’, ‘tr_TR’) в свойстве jsApiUrl в виде ULR-параметра ‘lang’: https://api-maps.yandex.ru/2.1/?lang=ru_RU |
Примеры использования
Пример добавления на карту тайлового слоя рисованной Яндекс-карты:
Пример добавления на карту тайлового слоя Яндекс-карты со спутниковыми снимками:
Пример добавления на карту тайлового слоя Гибридной Яндекс-карты, совмещающей рисованные дороги и прочие объекты с подложкой из спутниковых снимков: