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