Provided that a position has been obtained, this module can add a Map with Places of Interest (POI) and Places. The user can be made aware of nearby features and related information, displayed graphically. Features on the Map can be places of business, entertainment, and so on. They may include paths, roads, or forms of transport, enabling navigation optimization and assistance.
To perform navigation we need Routes from start to destination. These routes are made up of segments, where each RouteSegment can be considered a navigation subtask: 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 required 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 provides geocoding and routing information, which can be consumed by the application. There may be various GeoServices plugins for various tasks with some plugins providing more than one service. One QML Plugin must be created for each required GeoService plugin. Plugins are required for maps, routing and geocoding, and places, however the default plugin handles all four of these services. A plugin may require online access or may support on-board maps and data.
Note: Plugins may not provide features such as paging or relevance hints.
The following links provide more detailed information about maps and places:
| Maps and Navigation | Displaying maps and finding routes. |
| Places | Searching for and managing points of interest. |
|
Type describes a Location based services plugin |
|
|
Type describes a parameter to a Plugin |
|
Type displays a geographic circle on a Map |
|
|
Type displays a map |
|
|
Item displays the current valid copyright notice for a Map element |
|
|
Type is a container for map items |
|
|
Used to populate Map from a model |
|
|
Type represents a parameter for a Map element. This type provides a mean to specify plugin-dependent optional parameters for a map |
|
|
Type displays an arbitrary Qt Quick object on a Map |
|
|
Type holds information about the camera capabilities for a specific map type |
|
|
Type holds information about a map type |
|
|
Type displays a polygon on a Map |
|
|
Type displays a polyline on a map |
|
|
Type displays a rectangle on a Map |
|
|
Type displays a Route on a Map |
|
|
Type provides Map gesture interaction |
|
|
Type provides basic information about pinch event |
|
|
Type offers functionalities to perform turn-by-turn navigation |
|
|
Displays a circle on a Map |
|
|
Displays an icon on a Map |
|
|
Used to populate Map with map objects from a model |
|
|
Displays a polygon on a Map |
|
|
Displays a polyline on a Map |
|
|
Displays a geographical route on a Map |
|
Type represents the information relevant to the point at which two RouteSegments meet |
|
|
Type represents one geographical route |
|
|
Type provides access to routes |
|
|
Type is used to provide query parameters to a RouteModel |
|
|
Type provides a mean to specify a waypoint in a RouteQuery in a more detailed way than by using a simple coordinate |
|
|
Type represents a segment of a Route |
|
Type provides support for searching operations related to geographic information |
|
Type represents a category that a Place can be associated with |
|
|
Type holds a contact detail such as a phone number or a website address |
|
|
Type holds contact details for a Place |
|
|
Type represents a location that is a position of interest |
|
|
Type holds additional data about a Place |
|
|
Type holds generic place attribute information |
|
|
Type provides a model of place editorials |
|
|
Type represents an icon image source which can have multiple sizes |
|
|
Type provides a model of place images |
|
|
Type identifies a user who contributed a particular Place content item |
|
|
Type holds place rating information |
|
|
Provides access to reviews of a Place |
|
|
Provides access to place search results |
|
|
Provides access to search term suggestions |
|
|
Holds data regarding the supplier of a place, a place's image, review, or editorial |
|
|
Type provides a model of the categories supported by a Plugin |
|
Type displays a geographic circle on a Map |
|
|
Type provides support for searching operations related to geographic information |
|
|
Type represents the information relevant to the point at which two RouteSegments meet |
|
|
Type displays a map |
|
|
Item displays the current valid copyright notice for a Map element |
|
|
Type is a container for map items |
|
|
Used to populate Map from a model |
|
|
Type represents a parameter for a Map element. This type provides a mean to specify plugin-dependent optional parameters for a map |
|
|
Type displays an arbitrary Qt Quick object on a Map |
|
|
Type holds information about the camera capabilities for a specific map type |
|
|
Type holds information about a map type |
|
|
Type represents one geographical route |
|
|
Type provides access to routes |
|
|
Type is used to provide query parameters to a RouteModel |
|
|
Type provides a mean to specify a waypoint in a RouteQuery in a more detailed way than by using a simple coordinate |
|
|
Type represents a segment of a Route |
|
|
Type describes a Location based services plugin |
|
|
Type describes a parameter to a Plugin |
|
|
Type displays a polygon on a Map |
|
|
Type displays a polyline on a map |
|
|
Type displays a rectangle on a Map |
|
|
Type displays a Route on a Map |
|
|
Type provides Map gesture interaction |
|
|
Type provides basic information about pinch event |
|
|
Type represents a category that a Place can be associated with |
|
|
Type holds a contact detail such as a phone number or a website address |
|
|
Type holds contact details for a Place |
|
|
Type represents a location that is a position of interest |
|
|
Type holds additional data about a Place |
|
|
Type holds generic place attribute information |
|
|
Type provides a model of place editorials |
|
|
Type represents an icon image source which can have multiple sizes |
|
|
Type provides a model of place images |
|
|
Type identifies a user who contributed a particular Place content item |
|
|
Type holds place rating information |
|
|
Provides access to reviews of a Place |
|
|
Provides access to place search results |
|
|
Provides access to search term suggestions |
|
|
Holds data regarding the supplier of a place, a place's image, review, or editorial |
|
|
Type provides a model of the categories supported by a Plugin |
