Плагин Qt Location Open Street Map

Обзор

Этот плагин геосервисов позволяет приложениям получать доступ к службам геолокации OpenStreetMap с помощью API Qt Location.

Данные, изображения и информация о картах предоставляются OpenMapSurfer, ThunderForest, OpenStreetMap и участниками проекта. Данные доступны по лицензии Open Database License.

Плагин геосервисов OpenStreetMap может быть загружен с использованием ключа плагина «osm».

Примечание: Начиная с Qt 5.6.2, доступные типы карт, предлагаемые этим плагином, могут изменяться (или быть удалены) без предварительного уведомления в зависимости от фактической доступности жизнеспособного открытого поставщика для каждого типа. Это также означает, что могут использоваться поставщики, предоставляющие тайлы по протоколу HTTPS. Это становится актуальным при использовании плагина OSM на таких платформах, как Android, для которых поддержка SSL не включена в Qt по умолчанию. Чтобы предотвратить эти изменения, следует использовать другой плагин геосервисов или установить параметр плагина osm.mapping.providersrepository.address на указанный пользователем репозиторий, чтобы полностью контролировать (и принять на себя ответственность за) выбор поставщика для каждого типа карты. Начиная с Qt 5.9.6, конечная точка nominatim по умолчанию, используемая для геокодирования и поиска мест, также изменилась на HTTPS-только.

Параметры

Дополнительные параметры

В следующей таблице перечислены дополнительные параметры, которые можно передать плагину OpenStreetMap.

Примечание: Начиная с Qt 5.5, все параметры ниже должны быть префиксрованы с osm. В предыдущих версиях префикс не требовался.

Пример использования параметров

Следующий пример демонстрирует, как создать экземпляр плагина OSM с параметрами для useragent и, при необходимости, пользовательского URL-адреса сервера, а также соответствующей информацией об авторских правах для поставщика тайлов. Дополнительно, можно выбрать другой сервер маршрутизации, помимо публичного OSRM.

QML

Plugin {
    name: "osm"
    PluginParameter { name: "osm.useragent"; value: "My great Qt OSM application" }
    PluginParameter { name: "osm.mapping.host"; value: "http://osm.tile.server.address/" }
    PluginParameter { name: "osm.mapping.copyright"; value: "All mine" }
    PluginParameter { name: "osm.routing.host"; value: "http://osrm.server.address/viaroute" }
    PluginParameter { name: "osm.geocoding.host"; value: "http://geocoding.server.address" }
}

Дополнительная информация, специфичная для плагина

Кэш тайлов

Плитки кешируются в каталоге QtLocation/osm в QStandardPaths::writableLocation (QStandardPaths::GenericCacheLocation). В системах, не имеющих понятия общего кэша, используется локальный кэш приложения QStandardPaths::CacheLocation.