Changes to Qt Location

Qt 6 is a result of the conscious effort to make the framework more efficient and easy to use.

We try to maintain binary and source compatibility for all the public APIs in each release. But some changes were inevitable in an effort to make Qt a better framework.

In this topic we summarize those changes in Qt Location, and provide guidance to handle them.

Breaking public API changes


  • The MapRectangle::backend, MapCircle::backend, MapPolyline::backend, and MapPolygon::backend properties have been removed.
  • The former Routing-related QML element types Route, RouteSegment, and RouteManeuver are now value types route, routeSegment, and routeManeuver. They can no longer be instantiated as items in QML, and their properties can not be bound to.
  • The former Mapping-related QML element types MapType and CameraCapabilities are now value types mapType and cameraCapabilities. They can no longer be instantiated as items in QML, and their properties can not be bound to.
  • The QGeoRouteLeg class and the QML equivalent, RouteLeg, have been merged into QGeoRoute (and the route type). A route can be an aggregate of several routes.
  • The Map type provides now minimal functionality without handling of user intput. The MapGestureArea was removed. The MapView type handles basic user input such as tap and drag events.


  • The QPlaceImage, QPlaceEditorial, and QPlaceReview classes have been folded into QPlaceContent.
  • The QPlaceContent API has been changed to give access to a list of QVariant values.
  • The former QML element types PlaceUser, PlaceRatings, PlaceAttribute, PlaceIcon, PlaceSupplier, and PlaceContactDetail are now value types user, ratings, placeAttribute, icon, supplier, and contactDetail. They can no longer be instantiated as items from QML, and their properties can not be bound to.

Experimental APIs

Functionality that had "labs" status has been removed. This includes the experimental framework for turn-by-turn navigation, as well as the MapObjects abstraction.

Backend Provider API

The backend provider API is no longer subject to binary and source compatibility guarantees.

Other API changes

This section contains API improvements that do not break source compatibility. However they might have an impact on the application logic, so it is still useful to know about them.

© 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.