Qt Location

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

Обзор

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

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

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

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

import QtPositioning 5.5
import QtLocation 5.6

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

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

#include <QGeoRoute>

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

QT += location

Подмодули

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

Места

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

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

для QML

для C++

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

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

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

для QML

для C++

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

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

QML Справочная информация по API	Полный список компонентов QML в API Qt Location
Справочная информация по API C++ по областям	Полный список классов и методов API Qt Location на C++ по областям
Справочная информация по API C++	Полный список классов и методов API Qt Location на C++
Примеры приложений	Примеры, демонстрирующие использование 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 Polygon Triangulation Library	Лицензия MIT
Clipper Polygon Clipping Library	Boost Software License 1.0
Earcut	Лицензия ISC
Earcut Polygon Triangulation Library	Лицензия ISC
Mapbox GL Native	Лицензия BSD 2-clause "Simplified"
Poly2Tri Polygon Triangulation Library	Лицензия BSD 3-clause "New" or "Revised"
RapidJSON	Лицензия MIT
Vector Tile Library	Лицензия ISC
Wagyu Geometry Processing Library	Лицензия MIT
cURL Parse Date	Лицензия MIT
geojson-cpp	Лицензия ISC
geojson-vt-cpp	Лицензия ISC
geometry.hpp	Лицензия ISC
kdbush.hpp	Лицензия ISC
libc++	Лицензии MIT и UIUC (BSD-подобная)
polylabel	Лицензия ISC
protozero	Лицензия BSD 2-clause "Simplified"
shelf-pack-cpp	Лицензия ISC
supercluster.hpp	Лицензия ISC
unique_resource	Boost Software License 1.0
variant	Лицензия BSD 3-clause "New" or "Revised"

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