Maps and Navigation (C++)

Maps and Navigation provides C++ utilities for geocoding (finding a geographic coordinate from a street address) and navigation (including driving and walking directions).

Currently it is not possible to interact with maps via C++. Mapping applications must use the Maps and Navigation (QML) API.


In C++, an address-to-coordinate query is performed using the geocode() method of the QGeoCodingManager class. For coordinate-to-address queries, the reverseGeocode() method is available on the same class. Instances of QGeoCodingManager are available via QGeoServiceProvider.

Key Classes

QGeoServiceProviderProvides a QGeoCodingManager instance ready for use.
QGeoCodingManagerAccepts queries and produces QGeoCodeReply objects.
QGeoCodeReplyContains the results of a geocoding query.

In C++, a route query is performed using the calculate() method of the QGeoRoutingManager class. The returned route reply can contain multiple routes to the same destination.

Key Classes

QGeoServiceProviderProvides a QGeoCodingManager instance ready for use.
QGeoRoutingManagerAccepts queries and produces QGeoRouteReply objects.
QGeoRouteReplyContains the results of a routing query.
QGeoRouteContains information about a route.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.