Плагин 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 является только источником чтения мест и не поддерживает функциональность сохранения вообще.)