Плагин Qt Location Mapbox GL

Обзор

Этот плагин геосервисов позволяет приложениям получать доступ к картографическим сервисам Mapbox с помощью API Qt Location. Использование этих сервисов регулируется условиями предоставления услуг Mapbox.

Этот плагин отличается от плагина Mapbox, поскольку использует движок карты Mapbox GL (Mapbox GL map engine) для визуализации как растровых, так и векторных тайлов в реальном времени. Преимуществами являются: текст, сохраняющий вертикальное положение, сглаживание шрифтов, плавное перетекание меток между уровнями масштабирования, плавное перемещение, наклон, вращение и непрерывное масштабирование.

Внешний вид и поведение векторных карт можно настроить, создав пользовательские стили карт. Это можно сделать с помощью инструментов, таких как Mapbox Studio.

Плагин геосервисов Mapbox GL может быть загружен, используя ключ плагина "mapboxgl".

Оба плагина геосервисов Mapbox требуют токена доступа для доступа к стилям карт и тайлам, размещенным на серверах Mapbox. Чтобы создать учетную запись Mapbox, посетите https://www.mapbox.com/pricing.

Примечание: API этого плагина представлен в Qt 5.9 как технологический предварительный просмотр.

Поддержка платформ

Плагин Qt Location Mapbox GL поддерживает следующие платформы:

• Microsoft Windows (win32) - Поддерживается, требуется MinGW 5.0+
• Linux X11 - Поддерживается, требуется GCC 4.9+
• macOS - Поддерживается
• Android - Поддерживается
• Embedded Linux - Поддерживается, требуется GCC 4.9+
• iOS - Поддерживается
• WinRT - Не поддерживается

Параметры

Дополнительные параметры плагина

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

Дополнительные параметры карты

Элемент Map, использующий этот плагин, также может быть настроен с помощью MapParameters, что позволяет изменять стиль и данные карты во время выполнения.

Примеры того, что в настоящее время можно контролировать с помощью MapParameter:

• Скрыть и показать части карты, такие как дороги и здания.
• Изменить свойства отрисовки, такие как цвет и непрозрачность различных частей карты.
• Изменить свойства макета, такие как толщина и стыки линий.
• Добавить данные на карту.
• Добавить спрайты на карту.

За исключением свойств экструзии и стилей, управляемых данными, каждое свойство, описанное в Спецификации стиля Mapbox, может быть изменено во время выполнения.

Свойство MapParameters, используемое для управления стилем карты во время выполнения, всегда имеет свойство type, за которым следуют пользовательские свойства, которые пытаются соответствовать наименованиям Спецификации стиля Mapbox насколько это возможно, заменяя дефис на верблюжий регистр по техническим причинам (например, line-cap будет переведено в lineCap).

Пример использования

В этом примере добавляются встроенные данные GeoJSON на карту. Просто добавление источника недостаточно для отображения данных. Также необходимо создать слой на основе этого источника. После добавления слоя нам также нужно задать свойства paint и layout. В данном случае мы меняем цвет линии на синий и ширину линии на 8 пикселей, а также устанавливаем круглые стыки и концы линий.

Map {
    plugin: Plugin { name: "mapboxgl" }

    center: QtPositioning.coordinate(60.170448, 24.942046) // Helsinki
    zoomLevel: 12

    MapParameter {
        type: "source"

        property var name: "routeSource"
        property var sourceType: "geojson"
        property var data: '{ "type": "FeatureCollection", "features": \
            [{ "type": "Feature", "properties": {}, "geometry": { \
            "type": "LineString", "coordinates": [[ 24.934938848018646, \
            60.16830257086771 ], [ 24.943315386772156, 60.16227776476442 ]]}}]}'
    }

    MapParameter {
        type: "layer"

        property var name: "route"
        property var layerType: "line"
        property var source: "routeSource"

        // Draw under the first road label layer
        // of the mapbox-streets style.
        property var before: "road-label-small"
    }

    MapParameter {
        type: "paint"

        property var layer: "route"
        property var lineColor: "blue"
        property var lineWidth: 8.0
    }

    MapParameter {
        type: "layout"

        property var layer: "route"
        property var lineJoin: "round"
        property var lineCap: "round"
    }
}

Обратите внимание, что порядок добавления параметров важен, поскольку между параметрами существует зависимость. Добавление слоя перед добавлением источника создаст неверный слой, то же самое относится к добавлению свойства paint для слоя, которого не существует.

Свойства рисования и компоновки также можно использовать для стилизации существующих слоев текущего стиля, а не только слоев, созданных во время выполнения. Mapbox Studio можно использовать для проверки слоев заданного стиля.