Qt Location

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

Обзор

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

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

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

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

import QtPositioning 5.15
import QtLocation 5.15

Модуль 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 и примеры

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

Справочник по 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	Использует Open Street Map и связанные сервисы.

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

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

GeoServices	Информация о плагинах Qt Location GeoServices
Места	Информация для разработчиков бэкэнда мест
Изменения API	Информация об изменениях API QML с версии 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-пунктная («упрощенная»)
Библиотека триангуляции многоугольников Poly2Tri	Лицензия BSD 3-пунктная («новая» или «пересмотренная»)
RapidJSON	Лицензия MIT
Библиотека векторных тайлов	Лицензия ISC
Библиотека обработки геометрии Wagyu	Лицензия MIT
Парсер даты cURL	Лицензия MIT
geojson-cpp	Лицензия ISC
geojson-vt-cpp	Лицензия ISC
geometry.hpp	Лицензия ISC
Библиотека упрощения полилиний geosimplify-js	Лицензия geosimplify-js
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.15/qtlocation-index.html