Qt Location

API Qt Location помогает создавать работоспособные решения для отображения карт, используя данные, доступные от некоторых популярных сервисов геолокации.

Обзор

API Qt Location позволяет:

доступ и отображение данных карт,
поддержка жестов касания на определенной области карты,
запросы для определенной географической локации и маршрута,
добавление дополнительных слоев поверх, таких как полилинии и окружности,
и поиск мест и связанных изображений.

Начало работы

Для загрузки модуля Qt Location добавьте следующее в ваши .qml файлы

import QtPositioning 5.12
import QtLocation 5.12

Модуль QML QtLocation зависит от модуля QML QtPositioning. Поэтому каждое приложение QML, которое импортирует модуль QML QtLocation, также должно импортировать модуль QtPositioning.

Для проектов на C++ необходимо включить заголовок, соответствующий текущему случаю использования, например, приложения, использующие маршруты, могут использовать

#include <QGeoRoute>

Файл .pro должен содержать ключевое слово location

QT += location

Подмодули

API разделен на подмодули, предоставляющие интерфейсы QML и C++ для конкретных целей. Они в основном фокусируются на информации о картах и местах. Требуемые данные о местоположении можно получить с помощью модуля QtPositioning.

Места

Подмодуль Места — это естественное дополнение к модулю Позиционирование, предоставляя источник географических данных о местах интереса (POI). Помимо исходной информации, API предоставляет информацию о местоположении, размере и другой связанной информации о POI. API Места также может получать изображения, отзывы и другую информацию, связанную с местом.

Введение в Места:

для QML

для C++

Карты и навигация

Модуль предоставляет альтернативы QML и C++ для карт и навигации. Альтернатива C++ предоставляет служебные классы для получения геокодирования (нахождение географических координат по адресу) и навигации (включая маршруты на автомобиле и пешком) информации, в то время как ее аналог QML предоставляет UI-компоненты для отображения информации.

Введение в Карты и навигацию:

для QML

для C++

Справочные материалы API и примеры

Ниже приведены списки классов и UI-компонентов, предоставляемых модулем, с примерами приложений для демонстрации их использования:

QML Справочник API	Полный список QML-компонентов в API Qt Location
C++ Справочник API по областям	Полный список классов и методов C++ API Qt Location, отсортированных по областям
C++ Справочник API	Полный список классов и методов C++ API Qt Location
Примеры приложений	Примеры, демонстрирующие использование API Qt Location
Учебник по Картам и навигации	Учебник, знакомящий с типами QML карт

Ссылки на плагины и параметры

Информация о плагинах, важные замечания об их использовании, параметры, которые можно предоставить для влияния на их поведение.

Плагин Qt Location Esri	Использует Esri для сервисов геолокации.
Плагин Qt Location HERE	Использует соответствующие сервисы, предоставляемые HERE.
Плагин Qt Location Items Overlay	Предоставляет пустую карту, предназначенную для использования в качестве фона для слоев наложений для элементов карты.
Плагин Qt Location Mapbox GL	Использует Mapbox GL для сервисов геолокации.
Плагин Qt Location Mapbox	Использует Mapbox для сервисов геолокации.
Плагин Qt Location Open Street Map	Использует Open Street Map и связанные сервисы.

Реализация новых бэкэндов и портирование

Для системных интеграторов и дистрибуторов, информация, связанная с предоставлением Qt Location для новой платформы.

GeoServices	Информация о плагинах Qt Location GeoServices
Места	Информация для разработчиков бэкенда мест
Изменения API	Информация о изменениях QML API с версии 5.4

Лицензии и указания на авторов

Qt Location доступен по коммерческим лицензиям от The Qt Company. Кроме того, он доступен по лицензии GNU Lesser General Public License, версия 3, или GNU General Public License, версия 2. Подробности см. в Qt Licensing.

Кроме того, Qt Location потенциально содержит модули третьих сторон под следующими лицензиями с открытым исходным кодом:

Boost	Лицензия Boost Software License 1.0
CSS Color Parser	Лицензия MIT
Библиотека триангуляции многоугольников Clip2Tri	Лицензия MIT
Библиотека обрезки многоугольников Clipper, версия 6.4.0	Лицензия Boost Software License 1.0
Earcut	Лицензия ISC
Библиотека триангуляции многоугольников Earcut	Лицензия ISC
Mapbox GL Native	Лицензия BSD 2-clause "Упрощенная"
Библиотека триангуляции многоугольников Poly2Tri	Лицензия BSD 3-clause "Новая" или "Пересмотренная"
RapidJSON	Лицензия MIT
Библиотека векторных тайлов	Лицензия ISC
Библиотека обработки геометрии Wagyu	Лицензия MIT
cURL Parse Date	Лицензия MIT
geojson-cpp	Лицензия ISC
geojson-vt-cpp	Лицензия ISC
geometry.hpp	Лицензия ISC
kdbush.hpp	Лицензия ISC
libc++	Лицензии MIT и UIUC (похожая на BSD)
nunicode	Лицензия MIT
polylabel	Лицензия ISC
protozero	Лицензия BSD 2-clause "Упрощенная"
shelf-pack-cpp	Лицензия ISC
supercluster.hpp	Лицензия ISC
tao_tuple	Лицензия MIT
unique_resource	Лицензия Boost Software License 1.0
variant	Лицензия BSD 3-clause "Новая" или "Пересмотренная"

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtlocation-index.html