Плагин Qt Location Mapbox GL

Обзор

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

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

Внешний вид и поведение векторных карт можно настроить, создав пользовательские стили карт. Это можно сделать с помощью инструментов, таких как 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 — Поддерживается
• Встраиваемый Linux — Поддерживается, требуется GCC 4.9+
• iOS — Поддерживается
• WinRT — Не поддерживается

Параметры

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

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

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

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

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

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

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

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

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

В этом примере добавляются данные GeoJSON встраиваемого типа на карту. Простое добавление source недостаточно для отображения данных. Также необходимо создать layer, основанный на этом источнике. После добавления слоя, мы также должны настроить его свойства 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 для слоя, которого еще нет.

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