このページでは

C

Map QML Type

Mapタイプは地図を表示します。詳細...

Import Statement: import QtLocation
Since: Qt Quick Ultralite 2.10

プロパティ

方法

  • void pan(int dx, int dy)

詳細説明

Map型は地球の地図や画像を表示するために使用される。

地球の表面を2次元的に視覚化する方法はさまざまあるが、そのすべてに何らかの投影が関わっている。つまり、3D座標(緯度、経度)と画面上の2D座標(ピクセル単位のXとY)の間の数学的な関係である。Mapタイプは、地図データがPseudo-Mercator投影EPSG:3857を使用することを想定しています。

ユーザは、生成されたマップ画像にアクセスするために Map タイプが消費するQul::MapTileFetcher の実装を提供する必要があります。詳細については、マップタイルフェッチャーの統合を参照してください。

Map アイテムに表示される地理的領域はビューポートと呼ばれ、centerzoomLevel プロパティによって定義されます。center プロパティにはビューポートの中心を指定するgeoCoordinate が含まれ、zoomLevel はマップの縮尺を制御します。これらのプロパティの値の詳細については、それぞれのプロパティを参照してください。

使用例

次のスニペットはシンプルなマップを示しています。マップはフィンランドのオウル中心で、ズームレベルは17です。

import QtQuick
import QtPositioning
import QtLocation

Rectangle {
    id: root

    property real zoomLevel: 17

    Map {
        id: map

        anchors.fill: parent
        center {
            latitude: 65.011762
            longitude: 25.470841
        }
        zoomLevel: root.zoomLevel
        minimumZoomLevel: 10
        maximumZoomLevel: 18
    }
}

フィンランド、オウル市を中心としたシンプルな地図。

プロパティの説明

bearing : real

このプロパティはマップの方位を保持します。

デフォルト値は0 です。


center : geoCoordinate

このプロパティは、マッピングビューポートの中心を占める座標を保持します。無効な中心座標は無視されます。座標値は WGS84 データムを使用して指定する必要があります。

デフォルト値は任意の有効座標である。


maximumZoomLevel : real

ズームレベル このプロパティは、マップの最大有効ズームレベルを保持します。

デフ ォル ト 値は23 です。


minimumZoomLevel : real

このプロパティは、地図の有効なズームレベルの最小値を保持します。

デ フ ォ ル ト 値は0 です。


zoomLevel : real

このプロパティはマップのズームレベルを保持します。

ズーム・レベルの値が大きいほど、より詳細な情報が得られます。ズーム・レベルは常に非負です。デフォルト値は 8.0 です。タイルが利用可能な範囲を表す [minimumZoomLevel,maximumZoomLevel] の範囲外の値はクランプされます。


メソッドの説明

void pan(int dx, int dy)

マップを x 軸方向にdx ピクセル、y 軸方向にdy ピクセル移動します。

dx の正の値はマップを右に動かし、負の値はマップを左に動かします。dy の正の値はマップを下に動かし、負の値はマップを上に動かす。

パン中にcenterzoomLevel が変わることがあります。


特定の Qt ライセンスの下で利用可能です。
詳細を見る。