Подключаемый модуль 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 к карте. Просто добавление 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"
    }
}

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

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