Плагин 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().

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

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

В качестве параметра для рекомендаций поддерживается только указанный идентификатор места. Другие параметры, такие как limit, offset и область поиска, не поддерживаются. Это ограничение применяется при использовании плагина 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 является только источником данных о местах и не поддерживает функцию сохранения.)