Overview

Included with Qt Location is a geo services plugin which accesses the relevant HERE services provided by HERE/Nokia. The use of these services is governed by the terms and conditions available at https://developer.here.com/terms-conditions.

Note that accepting the terms and conditions only applies those terms and conditions to the use of the HERE geo services plugin and does not limit the use of the other geo services plugins that may be included with Qt.

The HERE geo services plugin can be loaded by using the plugin key "here".

The online plugin uses the tiled map classes, which caches tile data in heap memory and texture memory.

Parameters

Mandatory parameters

The following table lists mandatory parameters that must be passed to the HERE plugin.

The HERE geo services plugin requires an application id and token pair to authenticate the application with the HERE services. To obtain an application id and token pair visit https://developer.here.com/

Optional parameters

The following table lists optional parameters that can be passed to the HERE plugin.

Note: Since Qt 5.5 all parameters below must be prefixed with here. Previous versions did not require a prefix.

Parameter Usage Example

The following two examples show how to create a HERE plugin instance with parameters supplied for an application id and token, which is required for authentication.

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);

Places

The HERE provider remotely accesses places (read-only) from a REST based server. The specific capabilities and behaviours are outlined below:

Capabilities

Plugin Specific Behaviors and Limitations.

Search

The following list shows what core place data is returned during a place search:

• name
• location
• contact information
• attribution
• categories
• rating
• visibility

The following list shows further details that may be retrieved via QPlaceManager::getDetails()

• supplier
• extended attributes

Searching for Places

Search Term and Categories

The HERE plugin supports searching with a search term and category or categories, however both are not supported simultaneously.

• Valid usage: search term + search center
• Valid usage: category + search center
• Invalid usage: search term + category + search center

This limitation applies when using the HERE plugin with PlaceSearchModel and QPlaceManager::search().

Search Area

The HERE plugin only supports provision of a search center when searching for places via PlaceSearchModel and QPlaceManager::search(). A search center can be provided via a bounding circle, however the radius should be kept at the default value of -1. Typically a developer should not have to set the radius at all. If a developer sets a radius, it is ignored by the plugin and the boundaries are not honored.

In a similar manner only the center of a bounding box is taken into consideration when searching. The boundaries of the box are not honored.

A search center must be provided for all searches.

Relevancy Hints

The HERE plugin does not support relevancy hints. Any relevancy hints supplied to a search request are consequently ignored.

Search Term suggestions

Only a partial search term and search center is supported when retrieving suggestions. This limitation applies when using the HERE plugin with the PlaceSearchSuggestionModel and QPlaceManager::searchSuggestions().

Both search term and search center must be provided when retrieving search term suggestions.

Recommendations

Only a given place identifier is supported as a parameter for a recommendations. No other parameters such as limit, offset, and search area are supported. This limitation applies when using the HERE plugin with PlaceSearchModel and QPlaceManager::search().

Extended Attributes

The supported set of attributes provided by the HERE plugin are not fixed and may grow over time. Also the attributes provided may vary according to a place by place basis, e.g one place may provide opening hours while another does not. At the time of writing, it is known that some places provide openingHours (QPlaceAttribute::OpeningHours) and payment (QPlaceAttribute::Payment) methods but other attributes may be made available by the backend server. All places provided by the plugin will have the x_provider (QPlaceAttribute::Provider) attribute set to here.

Restrictions of Usage - ExtendedAttributes and Content

The extended attributes and rich content of places are not permitted to be saved. For QML this is related to Place::extendedAttributes, ImageModel, ReviewModel, and EditorialModel. For C++ this relates to QPlace::extendedAttribute(), QPlace::content() and QPlaceManager::getPlaceContent().

(Note that the HERE plugin is a read-only source of places and does not support saving functionality at all.)