- Qt 5.5
- Qt Location
- Qt Location C++ API
- Qt 5.5.1 Reference Documentation

# Qt Location C++ API

The Location API provides a library for mapping, navigation and place information.

The Qt Location API provides the developer with a set of functions to interact with maps, navigational data and places of interest. This is particularly useful when associated with current position information which can be retrieved via the QtPositioning module.

With the Maps API we can associate a position with a map in various formats supplied by a backend. Then the Places API could be used to populate places on the Map or even specify the current position as a place of interest and associate it with an icon, contact details and other information.

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

Maps and Navigation | Displaying maps and finding routes.
Places | Searching for and managing points of interest.
Geoservices Plugin Implementation | Implement new geoservices and positioning plugins.

## Geoservice Provider Classes

QGeoServiceProvider | Aggregates access to services which provide geographical information

## Maps and Navigation Classes

Currently it is not possible to interact with maps data via C++. The only available interface is the Maps and Navigation (QML) API.

QGeoManeuver | Represents the information relevant to the point at which two QGeoRouteSegments meet
QGeoRoute | Represents a route between two points
QGeoRouteReply | Manages an operation started by an instance of QGeoRoutingManager
QGeoRouteRequest | Represents the parameters and restrictions which define a request for routing information
QGeoRouteSegment | Represents a segment of a route
QGeoRoutingManager | Support for geographic routing operations

QGeoCodeReply | Manages an operation started by an instance of QGeoCodingManager
QGeoCodingManager | Support for geocoding operations

## Places Classes

QPlace | Represents a set of data about a place
QPlaceAttribute | Represents generic attribute information about a place
QPlaceCategory | Represents a category that a QPlace can be associated with
QPlaceContactDetail | Represents a contact detail such as a phone number or website url
QPlaceContent | Serves as the base class for rich content types
QPlaceContentReply | Manages a content retrieval operation started by an instance of QPlaceManager
QPlaceContentRequest | Represents the parameters of a content request
QPlaceDetailsReply | Manages a place details fetch operation started by an instance of QPlaceManager
QPlaceEditorial | Represents a publisher's article describing a place
QPlaceIcon | Represents an icon
QPlaceIdReply | Manages operations which return an identifier such as saving and removal operations of places and categories
QPlaceImage | Represents a reference to an image
QPlaceManager | The interface which allows clients to access places stored in a particular backend
QPlaceManagerEngine | Interface for implementers of QGeoServiceProvider plugins who want to provide access to place functionality
QPlaceMatchReply | Manages a place matching operation started by an instance of QPlaceManager
QPlaceMatchRequest | Used to find places from one manager that match those from another. It represents a set of request parameters
QPlaceProposedSearchResult | Represents a search result containing a proposed search
QPlaceRatings | Holds rating information about a place
QPlaceReply | Manages an operation started by an instance of QPlaceManager and serves as a base class for more specialized replies
QPlaceResult | Represents a search result containing a place
QPlaceReview | Represents a review of a place
QPlaceSearchReply | Manages a place search operation started by an instance of QPlaceManager
QPlaceSearchRequest | Represents the set of parameters for a search request
QPlaceSearchResult | The base class for search results
QPlaceSearchSuggestionReply | Manages a search suggestion operation started by an instance of QPlaceManager
QPlaceSupplier | Represents a supplier of a place or content associated with a place
QPlaceUser | Represents an individual user

## Geoservices and Positioning Plugin Classes

QGeoCodingManagerEngine | Interface and convenience methods to implementers of QGeoServiceProvider plugins who want to provide support for geocoding operations
QGeoRoutingManagerEngine | Interface and convenience methods to implementers of QGeoServiceProvider plugins who want to provide access to geographic routing information
QGeoServiceProviderFactory | Factory class used as the plugin interface for services related to geographical information
QPlaceManagerEngine | Interface for implementers of QGeoServiceProvider plugins who want to provide access to place functionality