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