ol/source/BingMaps~BingMaps
import BingMaps from 'ol/source/BingMaps.js';
Источник слоя для тайловых данных Bing Maps.
-
new BingMaps(options)
-
Имя Тип Описание cacheSizenumber | undefined Устарело. Вместо этого используйте параметр cacheSize слоя.
hidpiboolean (по умолчанию false) Если
true, будут запрошены тайлы hidpi.culturestring (по умолчанию 'en-us') Код языка и региона.
keystring Ключ API Bing Maps. Получите свой на сайте https://www.bingmapsportal.com/.
imagerySetstring Тип изображений.
interpolateboolean (по умолчанию true) Использовать интерполированные значения при передискретизации. По умолчанию при передискретизации используется линейная интерполяция. Установите значение false, чтобы вместо неё использовать метод ближайшего соседа.
maxZoomnumber (по умолчанию 21) Максимальный уровень масштабирования. По умолчанию используется значение, указанное службой BingMaps.
reprojectionErrorThresholdnumber (по умолчанию 0.5) Максимально допустимая погрешность перепроецирования (в пикселях). Большие значения могут повысить производительность перепроецирования, но снизить точность.
tileLoadFunctionLoadFunction | undefined Необязательная функция для загрузки тайла по URL. По умолчанию используется
function(imageTile, src) { imageTile.getImage().src = src; };wrapXboolean (по умолчанию true) Следует ли зацикливать мир по горизонтали.
transitionnumber | undefined Длительность перехода прозрачности при отрисовке. Чтобы отключить переход прозрачности, передайте
transition: 0.zDirectionnumber | NearestDirectionFunction (по умолчанию 0) Выберите, использовать ли тайлы с более высоким или более низким уровнем масштабирования при масштабировании между целыми уровнями. См.
getZForResolution.placeholderTilesboolean | undefined Показывать ли пустые тайлы BingMaps при масштабировании за пределы максимального уровня, доступного для данной области. Если
false, запросы за пределами максимального уровня масштабирования не вернут тайл. Еслиtrue, будет возвращён пустой тайл. Если параметр не задан, применяется поведение по умолчанию для набора изображений, которое различается для каждого набора изображений в BingMaps.urlstring (по умолчанию 'https://dev.virtualearth.net/REST/v1/Imagery/Metadata/') URL API метаданных Bing Maps.
- Устарело
- Поддержка Bing Maps for Enterprise прекращается 30 июня 2028 года. Вместо этого используйте `ol/source/ImageTile` с API тайлов Azure Maps. Инструкции см. в примере azure-maps.
Генерирует события:
-
change(BaseEvent) — Общее событие изменения. Вызывается при увеличении счётчика ревизий. -
error(BaseEvent) — Общее событие ошибки. Вызывается при возникновении ошибки. -
propertychange(ObjectEvent) — Вызывается при изменении свойства. -
tileloadend(TileSourceEvent) — Вызывается по завершении загрузки тайла: когда его данные загружены или когда загрузка была прервана, поскольку тайл больше не нужен. -
tileloaderror(TileSourceEvent) — Вызывается, если при загрузке тайла произошла ошибка. Обратите внимание, что это событие не следует использовать для повторной загрузки тайлов. Подробности см. вload. -
tileloadstart(TileSourceEvent) — Вызывается при начале загрузки тайла.
Наследует
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и отправляет событие 'change'.
-
clear() унаследовано
-
Удаляет все кэшированные перепроецированные тайлы из источника. В следующем цикле отрисовки будут созданы новые тайлы.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр event может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если какой-либо из обработчиков вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getApiKey(){string}
-
Получает API-ключ, используемый для этого источника.
Возвращает:
API-ключ.
-
getAttributions(){Attribution} унаследовано
-
Получает функцию атрибуции для источника.
Возвращает:
Функция атрибуции.
-
getAttributionsCollapsible(){boolean} унаследовано
-
Возвращает:
Можно ли сворачивать атрибуции.
-
getImagerySet(){string}
-
Получает набор изображений, связанный с этим источником.
Возвращает:
Набор изображений.
-
getKeys(){Array.<string>} унаследовано
-
Получает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getProjection(){Projection | null} унаследовано
-
Получает проекцию источника.
Возвращает:
Проекция.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Получает объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRevision(){number} унаследовано
-
Получает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Номер ревизии.
-
getState(){State} унаследовано
-
Получает состояние источника. Возможные состояния см. в разделе
State.Возвращает:
Состояние.
-
getTileGrid(){TileGrid | null} унаследовано
-
Возвращает сетку тайлов источника тайлов.
Возвращает:
Сетка тайлов.
-
getTileLoadFunction(){LoadFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию загрузки тайлов источника.
Возвращает:
TileLoadFunction
-
getTileUrlFunction(){UrlFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию URL тайлов источника.
Возвращает:
TileUrlFunction
-
getUrls(){!Array.<string> | null} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает URL-адреса, используемые для этого источника. Если вместо url или urls используется tileUrlFunction, будет возвращено значение null.
Возвращает:
URL-адреса.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Однократно ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
refresh() унаследовано
-
Обновляет источник. Источник будет очищен, а данные с сервера загружены заново.
-
set(key, value, silent) унаследовано
-
Задаёт значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без отправки события.
-
setAttributions(attributions) унаследовано
-
Задаёт атрибуции источника.
Имя Тип Описание attributionsAttributionLike | undefined Атрибуции. Можно передать как
string,Array<string>,Attributionилиundefined. -
setProperties(values, silent) унаследовано
-
Задаёт набор пар «ключ-значение». Обратите внимание: это изменяет существующие свойства и добавляет новые (существующие свойства не удаляются).
Имя Тип Описание valuesPartial.<NoInfer.<Properties>> Значения.
silentboolean | undefined Обновить без отправки события.
-
setRenderReprojectionEdges(render) унаследовано
-
Задаёт, следует ли отображать границы перепроецирования (обычно для отладки).
Имя Тип Описание renderboolean Отображать границы.
-
setTileGridForProjection(projection, tilegrid) унаследовано
-
Задаёт сетку тайлов, которая будет использоваться при перепроецировании тайлов в указанную проекцию вместо стандартной сетки тайлов для этой проекции.
Это может быть полезно, если стандартную сетку тайлов невозможно создать (например, для проекции не задана область охвата) или по соображениям оптимизации (пользовательский размер тайла, разрешения и т. д.).
Имя Тип Описание projectionProjectionLike Проекция.
tilegridTileGrid Сетка тайлов для этой проекции.
-
setTileLoadFunction(tileLoadFunction) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию загрузки тайлов источника.
Имя Тип Описание tileLoadFunctionLoadFunction Функция загрузки тайлов.
-
setTileUrlFunction(tileUrlFunction, key) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию URL тайлов источника.
Имя Тип Описание tileUrlFunctionUrlFunction Функция URL тайлов.
keystring | undefined Новый необязательный ключ тайла для источника.
-
setUrl(url) унаследовано
-
Задаёт URL для запросов.
Имя Тип Описание urlstring URL.
-
setUrls(urls) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт URL-адреса для запросов.
Имя Тип Описание urlsArray.<string> URL-адреса.
-
un(type, listener) унаследовано
-
Прекращает ожидание события указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) унаследовано
-
Сбрасывает свойство.
Имя Тип Описание keystring Имя ключа.
silentboolean | undefined Сбросить без отправки события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_source_BingMaps-BingMaps.html