C

Map QML Type

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

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

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

Map アイテムに表示される地理的領域はビューポートと呼ばれ、center とzoomLevel プロパティによって定義されます。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 の正の値はマップを下に動かし、負の値はマップを上に動かす。

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

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