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.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.15/location-plugin-mapbox.html
