Qt Location QML Types

Overview

The identifying string for this module is QtLocation. To use include the following import statement in the QML file.

import QtLocation 5.0

Location QML Concepts

Provided that a position has been obtained this module can add a Map with positions of interest and Places. The user can be made aware of nearby features and related information, displayed graphically. Features on the Map may be places of business, entertainment and so on. They may include paths, roads, or forms of transport leading so that navigation optimization and assistance are possible.

To perform navigation we need Routes from start to destination. These routes are made up of segments. Each RouteSegment can be considered a navigation sub-task: drive 100 meters, turn left. The beginning and end of each segment is a waypoint, that is, one part of our journey.

A typical use case for the API is a user looking for a particular type of place, say a restaurant. The user could enter a search string into the map application and respond to a list or display of results for restaurants "near" the device. The application could then be used to navigate to the restaurant using an optimized route that is aware of features in the environment that can help or hinder the journey. The navigation then proceeds with the user's progress monitored by means of the current Location. In the context of this API the map application would be aware of the location and size of various places and the location of the user. Plugins would supply the data used by the application to determine routes and navigation instructions. The Place types would hold information about the destination and surrounding objects including displayable representations. The Map type would enable this information to be displayed, panned, zoomed and so on. The Route would be determined by a plugin with each RouteSegment holding the navigation instructions guided by the updated current Location.

Plugins are a means of specifying which Location based service to use. For example, a plugin may allow connection to a provider's service that handles geocoding and routing that the API and application can use. There may be various GeoServices plugins for various tasks with some plugins providing more than one service. One QML Plugin should be created for each required GeoService plugin. Plugins are required for maps, routing and geocoding, however the default plugin handles all three of these services. A plugin may require online access or may support on-board maps and data. The default "nokia" plugin only supports online use. The connection would be managed by QNetworkInfo and QNetworkConfigurationManager.

Note: : Plugins may not provide various features such as paging or relevance hints. Since plugins may be supplied by other providers, support for these aspects is dependent on the provider's implementation.

The following table provides links to more detailed information on sections of the Qt Location QML API.

Maps and NavigationDisplaying maps and finding routes.
PlacesSearching for and managing points of interest.

Common QML Types

Plugin

The Plugin type describes a Location based services plugin.

PluginParameter

The PluginParameter type describes a parameter to a Plugin.

Maps QML Types

MapCircle

The MapCircle type displays a geographic circle on a Map.

Map

The Map type displays a map.

MapPinchEvent

MapPinchEvent type provides basic information about pinch event.

MapGestureArea

The MapGestureArea type provides Map gesture interaction.

MapItemView

The MapItemView is used to populate Map from a model.

MapMouseArea

The MapMouseArea item enables simple mouse handling.

MapMouseEvent

The MapMouseEvent object provides information about a mouse event.

MapQuickItem

The MapQuickItem type displays an arbitrary Qt Quick object on a Map.

MapType

The MapType type holds information about a map type.

MapPolygon

The MapPolygon type displays a polygon on a Map

MapPolyline

The MapPolyline type displays a polyline on a map.

MapRectangle

The MapRectangle type displays a rectangle on a Map.

MapRoute

The MapRoute type displays a Route on a Map.

Navigation and Routing QML Types

RouteManeuver

The RouteManeuver type represents the information relevant to the point at which two RouteSegments meet.

Route

The Route type represents one geographical route.

RouteModel

The RouteModel type provides access to routes.

RouteQuery

The RouteQuery type is used to provide query parameters to a RouteModel.

RouteSegment

The RouteSegment type represents a segment of a Route.

Geocoding QML Types

GeocodeModel

The GeocodeModel type provides support for searching operations related to geographic information.

Places QML Types

Category

The Category type represents a category that a Place can be associated with.

ContactDetails

The ContactDetails type holds contact details for a Place.

ContactDetail

The ContactDetail type holds a contact detail such as a phone number or a website address.

Place

The Place type represents a location that is a position of interest.

ExtendedAttributes

The ExtendedAttributes type holds additional data about a Place.

PlaceAttribute

The PlaceAttribute type holds generic place attribute information.

EditorialModel

The EditorialModel type provides a model of place editorials.

Icon

The Icon type represents an icon image source which can have multiple sizes.

ImageModel

The ImageModel type provides a model of place images.

User

The User type identifies a user who contributed a particular Place content item.

Ratings

The Ratings type holds place rating information.

ReviewModel

Provides access to reviews of a Place.

PlaceSearchModel

Provides access to place search results.

PlaceSearchSuggestionModel

Provides access to search term suggestions.

Supplier

Holds data regarding the supplier of a place, a place's image, review, or editorial.

CategoryModel

The CategoryModel type provides a model of the categories supported by a Plugin.

Alphabetical Listing of all QML Types

Category

The Category type represents a category that a Place can be associated with.

ContactDetails

The ContactDetails type holds contact details for a Place.

ContactDetail

The ContactDetail type holds a contact detail such as a phone number or a website address.

Place

The Place type represents a location that is a position of interest.

ExtendedAttributes

The ExtendedAttributes type holds additional data about a Place.

PlaceAttribute

The PlaceAttribute type holds generic place attribute information.

EditorialModel

The EditorialModel type provides a model of place editorials.

Icon

The Icon type represents an icon image source which can have multiple sizes.

ImageModel

The ImageModel type provides a model of place images.

User

The User type identifies a user who contributed a particular Place content item.

Ratings

The Ratings type holds place rating information.

ReviewModel

Provides access to reviews of a Place.

PlaceSearchModel

Provides access to place search results.

PlaceSearchSuggestionModel

Provides access to search term suggestions.

Supplier

Holds data regarding the supplier of a place, a place's image, review, or editorial.

CategoryModel

The CategoryModel type provides a model of the categories supported by a Plugin.

MapCircle

The MapCircle type displays a geographic circle on a Map.

GeocodeModel

The GeocodeModel type provides support for searching operations related to geographic information.

RouteManeuver

The RouteManeuver type represents the information relevant to the point at which two RouteSegments meet.

Map

The Map type displays a map.

MapPinchEvent

MapPinchEvent type provides basic information about pinch event.

MapGestureArea

The MapGestureArea type provides Map gesture interaction.

MapItemView

The MapItemView is used to populate Map from a model.

MapMouseArea

The MapMouseArea item enables simple mouse handling.

MapMouseEvent

The MapMouseEvent object provides information about a mouse event.

MapQuickItem

The MapQuickItem type displays an arbitrary Qt Quick object on a Map.

MapType

The MapType type holds information about a map type.

Route

The Route type represents one geographical route.

RouteModel

The RouteModel type provides access to routes.

RouteQuery

The RouteQuery type is used to provide query parameters to a RouteModel.

RouteSegment

The RouteSegment type represents a segment of a Route.

Plugin

The Plugin type describes a Location based services plugin.

PluginParameter

The PluginParameter type describes a parameter to a Plugin.

MapPolygon

The MapPolygon type displays a polygon on a Map

MapPolyline

The MapPolyline type displays a polyline on a map.

MapRectangle

The MapRectangle type displays a rectangle on a Map.

MapRoute

The MapRoute type displays a Route on a Map.