Подключаемый модуль 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. Это включает идентификаторы карт, включенные в плагин по умолчанию (документировано здесь в разделе Идентификаторы классических карт 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 | Строка 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.13/location-plugin-mapbox.html
