summaryrefslogtreecommitdiff
path: root/examples/location/minimal_map/doc/src/minimal_map.qdoc
blob: 24b89247d2c8eff3a9abd5b856e26894ff44fddd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\example minimal_map
\title Minimal Map (QML)
\ingroup qtlocation-examples
\brief The minimum code to display a map using Qt Quick.

\image minimal_map.png

\e {Minimal Map} demonstrates how to use the \l{Map} item to render a map.
It shows the minimum amount of code needed to display the map, and can be used
as a basis for further experimentation.

\include examples-run.qdocinc

\section1 C++ Code

In \c main.cpp we use only the QGuiApplication and QQmlApplicationEngine
classes.

\quotefromfile minimal_map/main.cpp
\skipto #include
\printto main

In the main function, we first instantiate a QGuiApplication object.
Then we create a QQmlApplicationEngine and tell it to load \c main.qml
from the \l{The Qt Resource System}{Qt Resource System}.

Finally, QGuiApplication::exec() launches the main event loop.

\printuntil }

\section1 QML Code

In \c main.qml, we import the \l {Qt Location QML Types}{QtLocation} QML module
and its depending \l {Qt Positioning QML Types}{QtPositioning} QML module.
Next, we create the top level window, set a sensible default size, and make
it visible. The window will be filled by a \l [QML]{Map} item showing the map.

\quotefromfile minimal_map/main.qml
\skipto import
\printuntil }
\printline }
\skipto Map
\printuntil }
\printline }

The \l [QML]{Plugin} item is necessary to define the map provider we are
going to use. The example can work with any of the available geo services
plugins. However, some plugins may require additional plugin parameters
in order to function correctly and we can use \l [QML]{PluginParameter}
to specify them. In this example, we use the \c osm plugin, which is a
\l {Qt Location Open Street Map Plugin} and does not require any parameters.

In the \l [QML]{Map} item, we refer to the \c plugin we use and we set the \c
center and the \c zoomLevel of the map.

\section1 Requirements

The example requires a working internet connection to download
\c OpenStreetMap map tiles. An optional system proxy should be picked
up automatically.
*/