Плагин Qt Location Mapbox
Обзор
Этот плагин геосервисов позволяет приложениям получить доступ к службам геолокации Mapbox с использованием API Qt Location. Использование этих сервисов регулируется условиями предоставления услуг Mapbox. Для использования этих сервисов требуется токен доступа. Данные предоставляются OpenStreetMap и другими.
Плагин геосервисов Mapbox может быть загружен с помощью ключа плагина "mapbox".
Параметры
Обязательные параметры
В следующей таблице перечислены обязательные параметры, которые необходимо передать плагину Mapbox.
| Параметр | Описание |
|---|---|
| mapbox.access_token | Токен доступа, предоставленный Mapbox. Подробнее |
Плагину геосервисов Mapbox требуется токен доступа и идентификатор карты для использования сервисов Mapbox. Чтобы создать учетную запись Mapbox, посетите https://www.mapbox.com/#signup.
Необязательные параметры
В следующей таблице перечислены необязательные параметры, которые можно передать плагину Mapbox.
| Параметр | Описание |
|---|---|
| mapbox.mapping.map_id, mapbox.map_id (устаревший) | Идентификатор карты Mapbox для отображения. Пример идентификатора: "examples.map-zr0njcqy". Если этот параметр присутствует, указанный тип карты будет использоваться по умолчанию, если другой не выбран. Если он отсутствует, используется идентификатор карты Mapbox по умолчанию "mapbox.streets". Примечание: в данном параметре и в mapbox.mapping.additional_map_ids нельзя использовать повторяющиеся map_ids. Это включает map_ids, включенные в плагин по умолчанию (документировано здесь в разделе Идентификаторы классических карт Mapbox). В противном случае произойдет повреждение кеша тайлов. |
| mapbox.mapping.additional_map_ids | Дополнительные идентификаторы карт Mapbox, разделенные запятыми, которые будут добавлены к доступным типам карт. |
| mapbox.mapping.format, mapbox.format (устаревший) | Формат данных для загрузки тайлов, доступные значения: "png", "png32", "png64", "png128", "png256" (PNG с полным, 32, 64, 128 и 256-цветной палитрой), "jpg70", "jpg80", "jpg90" (JPEG со сжатием 70%, 80% и 90%). Значение по умолчанию — "png". |
| mapbox.mapping.highdpi_tiles | Требовать ли тайлы высокой плотности пикселей. Допустимые значения: true и false. Значение по умолчанию — false. |
| useragent | Строка user agent, устанавливаемая при выполнении сетевых запросов. |
| mapbox.mapping.cache.directory | Абсолютный путь к каталогу кеша тайлов карты, используемому в качестве сетевого кеша диска. По умолчанию кеш находится в подкаталоге |
| mapbox.mapping.cache.disk.cost_strategy | Стратегия расчета стоимости для кеширования тайлов карт на диске. Допустимые значения: bytesize и unitary. Используя bytesize, соответствующий параметр размера (mapbox.mapping.cache.disk.size) будет интерпретироваться как байты. Используя unitary, они будут интерпретироваться как количество тайлов. Значение по умолчанию для этого параметра — unitary. |
| mapbox.mapping.cache.disk.size | Размер кеша на диске для тайлов карты. Размер кеша по умолчанию — 6000, если используется стратегия unitary, или 50 МБ, если используется стратегия bytesize. Обратите внимание, что 6000 — максимальное количество тайлов, которое позволяет кэшировать бесплатный тарифный план Mapbox. Перед увеличением этого значения обязательно ознакомьтесь с Условиями предоставления услуг Mapbox. |
| mapbox.mapping.cache.memory.cost_strategy | Стратегия расчета стоимости для кеширования тайлов карт в памяти. Допустимые значения: bytesize и unitary. Используя bytesize, соответствующий параметр размера (mapbox.mapping.cache.memory.size) будет интерпретироваться как байты. Используя unitary, они будут интерпретироваться как количество тайлов. Значение по умолчанию — bytesize. |
| mapbox.mapping.cache.memory.size | Размер кеша в памяти для тайлов карты. Размер по умолчанию — 100, если используется стратегия unitary, или 3 МБ, если используется стратегия bytesize. |
| mapbox.mapping.cache.texture.cost_strategy | Стратегия расчета стоимости для кеширования декомпрессированных тайлов карты в памяти. Допустимые значения: bytesize и unitary. Используя bytesize, соответствующий параметр размера (mapbox.mapping.cache.texture.size) будет интерпретироваться как байты. Используя unitary, они будут интерпретироваться как количество тайлов. Значение по умолчанию — bytesize. |
| mapbox.mapping.cache.texture.size | Размер кеша текстур для тайлов карты. Размер по умолчанию — 30, если используется стратегия unitary, или 6 МБ, если используется стратегия bytesize. Обратите внимание, что кеш текстур имеет минимальный размер, зависящий от размера области просмотра карты (он должен содержать достаточно данных для отображения тайлов, которые в данный момент видны на дисплее). Это значение — количество тайлов, которое будет кэшироваться помимо минимального необходимого размера. |
| mapbox.mapping.prefetching_style | Этот параметр позволяет указать, как будет выполняться предварительная загрузка тайлов движком. Значение по умолчанию, TwoNeighbourLayers, заставляет движок предварительно загружать тайлы для слоя выше и ниже текущего слоя тайлов, обеспечивая готовые тайлы при приближении или отдалении от текущего уровня масштабирования. OneNeighbourLayer предварительно загружает только один слой, ближайший к текущему уровню масштабирования. Наконец, NoPrefetching позволяет отключить предварительную загрузку, поэтому будут загружаться только видимые тайлы. Обратите внимание, что в зависимости от активного типа карты этот параметр может быть проигнорирован. |
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/location-plugin-mapbox.html
