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). Игнорирование этого может привести к повреждению кэша тайлов. |
| 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/qt-5.12/location-plugin-mapbox.html
