Подключаемый модуль 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 запрещено использовать повторяющиеся идентификаторы карт. Это включает в себя идентификаторы карт, включенные в плагин по умолчанию (документировано здесь в разделе Идентификаторы классических карт Mapbox). В противном случае может произойти повреждение кэша тайлов. |
| 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 | Строка пользовательского агента, устанавливаемая при выполнении сетевых запросов. |
| 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/archives/qt-5.11/location-plugin-mapbox.html
