C

Map QML Type

「マップ」タイプでは、地図が表示されます。詳細...

Import Statement:	`import QtLocation`
Since:	Qt Quick Ultralite 2.10

継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

bearing : real
center : geoCoordinate
maximumZoomLevel : real
minimumZoomLevel : real
zoomLevel : real

方法

void pan(int dx, int dy)

詳細説明

「Map」タイプは、地図や地球の画像を表示するために使用されます。

地球の表面を 2 次元で可視化するにはさまざまな方法がありますが、そのすべてに何らかの投影法、つまり 3 次元座標（緯度、経度）と画面上の 2 次元座標（ピクセル単位の X および Y）との間の数学的な関係が関わっています。 Map タイプは、地図データが疑似メルカトル図法（EPSG:3857）を使用していることを前提としています。

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

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

使用例

以下のスニペットは、シンプルな Map を示しています。このマップは、フィンランドのオウルを中心に、ズームレベル 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 に正の値を指定するとマップが下に移動し、負の値を指定すると上に移動します。

パン操作中は、center およびzoomLevel が変化する場合があります。

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。