Подключаемый модуль Qt Location HERE

Обзор

В Qt Location интегрирован плагин геосервисов, который обращается к соответствующим сервисам HERE, предоставляемым HERE/Nokia. Использование этих сервисов регулируется условиями использования, доступными по адресу https://developer.here.com/terms-conditions.

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

Плагин геосервисов HERE можно загрузить, используя ключ плагина «here».

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

Параметры

Обязательные параметры

В следующей таблице перечислены обязательные параметры, которые обязательно должны быть переданы плагину HERE.

Плагин геосервисов HERE требует пары идентификатора приложения и токена для аутентификации приложения в сервисах HERE. Для получения пары идентификатора приложения и токена посетите https://developer.here.com/

Необязательные параметры

В следующей таблице перечислены необязательные параметры, которые могут быть переданы плагину HERE.

Примечание: Начиная с Qt 5.5, все параметры ниже должны иметь префикс here. В предыдущих версиях префикс не требовался.

Пример использования параметров

В следующих двух примерах показано, как создать экземпляр плагина HERE с параметрами, предоставляемыми для идентификатора и токена приложения, которые необходимы для аутентификации.

QML

Plugin {
    name: "here"
    PluginParameter { name: "here.app_id"; value: "myapp" }
    PluginParameter { name: "here.token"; value: "abcdefg12345" }
}

C++

QMap<QString,QVariant> params;
params["here.app_id"] = "myapp";
params["here.token"] = "abcdefg12345";

QGeoServiceProvider *gsp = new QGeoServiceProvider("here", params);

Места

Поставщик HERE удаленно получает данные о местах (только чтение) с сервера на основе REST. Конкретные возможности и поведение описаны ниже:

Возможности

Поведение и ограничения плагина

Поиск

В этом списке показано, какие основные данные о месте возвращаются при поиске места:

• имя
• местоположение
• контактная информация
• атрибуция
• категории
• оценка
• видимость

В этом списке показаны дополнительные детали, которые можно получить с помощью QPlaceManager::getDetails()

• поставщик
• расширенные атрибуты

Поиск мест

Поисковый запрос и категории

Плагин HERE поддерживает поиск по искомому запросу и категории или категориям, однако оба не поддерживаются одновременно.

• Допустимое использование: искомый запрос + центр поиска
• Допустимое использование: категория + центр поиска
• Недопустимое использование: искомый запрос + категория + центр поиска

Это ограничение применяется при использовании плагина HERE с PlaceSearchModel и QPlaceManager::search().

Область поиска

Плагин HERE поддерживает только предоставление центра поиска при поиске мест с помощью PlaceSearchModel и QPlaceManager::search(). Центр поиска может быть предоставлен с помощью окружности, однако радиус следует сохранить по умолчанию — -1. Как правило, разработчик не должен устанавливать радиус. Если разработчик установит радиус, он будет игнорироваться плагином, и границы не будут учитываться.

Аналогичным образом, при поиске учитывается только центр прямоугольной области, но границы прямоугольника не учитываются.

Центр поиска обязателен для всех поисков.

Подсказки релевантности

Плагин HERE не поддерживает подсказки релевантности. Любые подсказки релевантности, предоставленные в запросе на поиск, будут проигнорированы.

Предложения по поисковому запросу

При получении предложений по поисковому запросу поддерживается только частичный искомый запрос и центр поиска. Это ограничение применяется при использовании плагина HERE с PlaceSearchSuggestionModel и QPlaceManager::searchSuggestions().

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

Рекомендации

Только указанный идентификатор места поддерживается в качестве параметра для рекомендаций. Другие параметры, такие как предел, смещение и область поиска, не поддерживаются. Это ограничение применяется при использовании плагина HERE с PlaceSearchModel и QPlaceManager::search().

Расширенные атрибуты

Поддерживаемый набор атрибутов, предоставляемых плагином HERE, не является фиксированным и может увеличиваться со временем. Также предоставляемые атрибуты могут варьироваться в зависимости от места, например, одно место может предоставлять часы работы, а другое — нет. На момент написания известно, что некоторые места предоставляют openingHours (QPlaceAttribute::OpeningHours) и payment (QPlaceAttribute::Payment), но другие атрибуты могут быть доступны сервером-обработчиком. У всех мест, предоставляемых плагином, будет установлен атрибут x_provider (QPlaceAttribute::Provider) со значением here.

Ограничения использования - Расширенные атрибуты и контент

Сохранение расширенных атрибутов и богатого контента мест запрещено. Для QML это связано с Place::extendedAttributes, ImageModel, ReviewModel и EditorialModel. Для C++ это относится к QPlace::extendedAttribute(), QPlace::content() и QPlaceManager::getPlaceContent().

(Обратите внимание, что плагин HERE является только источником чтения мест и не поддерживает функции сохранения.)