Подключаемый модуль 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.enterprise | Логическое значение, указывающее, получен ли маркер доступа от учетной записи Mapbox Enterprise. |
| mapbox.mapping.map_id, mapbox.map_id (устаревший) | Идентификатор карты Mapbox для отображения, например, "examples.map-zr0njcqy". Подробнее. Если этот параметр присутствует, указанный тип карты будет использоваться по умолчанию, если другой не выбран. Если он отсутствует, используется идентификатор карты Mapbox по умолчанию "mapbox.streets". Примечание: в этом параметре, а также в mapbox.mapping.additional_map_ids нельзя использовать повторяющиеся идентификаторы map_id. Это включает идентификаторы map_id, входящие в плагин по умолчанию (документировано здесь в разделе Идентификаторы карт Mapbox Classic). Несоблюдение этого может привести к повреждению кэша тайлов. |
| 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 позволяет отключить предзагрузку, так что будут загружаться только видимые тайлы. Обратите внимание, что в зависимости от активного типа карты, это указание может быть проигнорировано. |
| mapbox.routing.use_mapbox_text_instructions | Использовать ли текст инструкций, полученный от сервера (true), или текст, сгенерированный плагином (false). Значение по умолчанию true. Обратите внимание, что если необходимы инструкции на языке, не поддерживаемом напрямую Mapbox (см. здесь список поддерживаемых языков), можно использовать Qt Linguist для перевода QtLocation на нужный язык и установить этот параметр в false, чтобы использовать встроенные переведённые инструкции. |
Дополнительные атрибуты маршрутизации
При использовании этого плагина объекты RouteManeuver в возвращенном маршруте могут содержать дополнительные расширенные атрибуты (см. RouteManeuver::extendedAttributes), если доступны. Эти атрибуты подробно описаны в официальной документации API направлений Mapbox.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/location-plugin-mapbox.html
