Qt Location

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

Обзор

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

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

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

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

import QtPositioning 5.14
import QtLocation 5.14

Модуль 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 компонентов, предоставляемых модулем, с примерами приложений, демонстрирующих их использование:

Справочная информация API QML	Полный список QML компонентов в API Qt Location
Справочная информация API C++ по областям	Полный список классов и методов C++ API Qt Location, отсортированных по областям
Справочная информация API C++	Полный список классов и методов 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	Использует OpenStreetMap и связанные сервисы.

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

Для системных интеграторов и дистрибьюторов информация, связанная с обеспечением доступности 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 1.0
Парсер цветов CSS	Лицензия MIT
Библиотека триангуляции многоугольников Clip2Tri	Лицензия MIT
Библиотека обрезки многоугольников Clipper, версия 6.4.0	Лицензия Boost Software 1.0
Earcut	Лицензия ISC
Библиотека триангуляции многоугольников Earcut	Лицензия ISC
Mapbox GL Native	Лицензия BSD 2-пунктная «Упрощенная»
Библиотека триангуляции многоугольников Poly2Tri	Лицензия BSD 3-пунктная «Новая» или «Пересмотренная»
RapidJSON	Лицензия MIT
Библиотека векторных тайлов	Лицензия ISC
Библиотека обработки геометрии Wagyu	Лицензия MIT
Парсинг даты cURL	Лицензия 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-пунктная «Упрощенная»
shelf-pack-cpp	Лицензия ISC
supercluster.hpp	Лицензия ISC
tao_tuple	Лицензия MIT
unique_resource	Лицензия Boost Software 1.0
variant	Лицензия BSD 3-пунктная «Новая» или «Пересмотренная»

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