Qt Location

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

Обзор

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

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

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

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

import QtPositioning 5.13
import QtLocation 5.13

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

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

#include <QGeoRoute>

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

QT += location

Подмодули

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

Места

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

Вводная информация о местах:

для QML

для C++

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

Вводная информация о картах и навигации:

для QML

для C++

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

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

Справочная информация по 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 1.0
CSS Color Parser	Лицензия MIT
Clip2Tri Библиотека триангуляции многоугольников	Лицензия MIT
Библиотека Clipper для обрезки многоугольников, версия 6.4.0	Лицензия Boost Software 1.0
Earcut	Лицензия ISC
Библиотека Earcut для триангуляции многоугольников	Лицензия ISC
Mapbox GL Native	Лицензия BSD 2-clause "Simplified"
Библиотека Poly2Tri для триангуляции многоугольников	Лицензия BSD 3-clause "New" или "Revised"
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 "Simplified"
shelf-pack-cpp	Лицензия ISC
supercluster.hpp	Лицензия ISC
tao_tuple	Лицензия MIT
unique_resource	Лицензия Boost Software 1.0
variant	Лицензия BSD 3-clause "New" или "Revised"

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