Map QML Type

現在アクティブなmap type へのアクセス。

このプロパティは、アクティブなmap type を変更するために設定することができます。設定可能な値についてはsupportedMapTypes プロパティを参照してください。

mapTypeも参照。

このプロパティはマップの方位を保持します。マップに使用されているプラグインが方位をサポートしている場合、この値の有効範囲は 0 ～ 360 です。マップに使用されているプラグインが方位をサポートしていない場合、このプロパティを変更しても効果はありません。

このプロパティは QtLocation 5.9 で導入されました。

このプロパティは、マッピングビューポートの中心を占める座標を保持します。無効な中心座標は無視されます。

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

このプロパティは、マップ要素の背景色を保持します。

このプロパティは、著作権表示の可視性を保持します。通常、著作権表示は左下に表示されます。デフォルトでは、このプロパティはtrue に設定されています。

この読み取り専用プロパティは、最後に発生したマッピングサービスプロバイダのエラーを保持します。

• 地図。NoError - エラーは発生していません。
• Map.NotSupportedError -マップ プラグイン プロパティが設定されていないか、プラグインに関連付けられているマッピング マネージャがありません。
• Map.UnknownParameterError -プラグインが指定されたパラメータを認識できませんでした。
• Map.MissingRequiredParameterError - プラグインが指定したパラメータが見つかりません。
• Map.ConnectionError - プラグインがバックエンド サービスまたはデータベースに接続できませんでした。

QGeoServiceProvider::Errorも参照してください 。

この読み取り専用プロパティは、最新のマッピング・プロバイダ・エラーのテキスト表示を保持します。エラーが発生していない場合は、空の文字列が返されます。

関連するテキスト表現がないエラーが発生した場合は、空の文字列が返されることもあります。

QGeoServiceProvider::errorString()も参照してください 。

このプロパティは、マップを見るために使用されるカメラの視野を度単位で保持します。マップのプラグイン・プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、値は45度になります。

この値を変更すると、カメラとマップ間の距離も暗黙的に変更されるため、傾斜角度が0度の場合、このプロパティに使用されるどの値でも、結果として得られる画像は同じであることに注意してください。

このパラメータの詳細については、WikipediaのField of viewと Angle of viewの記事を参照してください。

このプロパティはQtLocation 5.9で導入されました。

minimumFieldOfView およびmaximumFieldOfViewも参照してください 。

すべてのマップアイテムのリストを順不同で返します。これらの項目には、型宣言の一部として静的に宣言された項目と、動的な項目 (addMapItem,MapItemView) が含まれます。

addMapItem,removeMapItem,clearMapItemsも参照してください 。

このプロパティは、マップが正常に初期化され、使用できる状態にあるかどうかを保持します。fromCoordinate やtoCoordinate などの一部のメソッドは、マップの準備が整うまでは動作しません。Map のアーキテクチャーにより、Component.onCompleted の代わりに、このプロパティに対して発せられるシグナルを使用し、すべてが期待通りに動作することを確認することをお勧めします。

このプロパティは、マップの最大有効視野を度単位で保持します。

使用されるplugin による最小傾斜視野が、このプロパティの上限となる。plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは179 になります。

このプロパティは QtLocation 5.9 で導入されました。

fieldOfView およびminimumFieldOfViewも参照してください 。

このプロパティは、マップに有効な傾きの最大値を度単位で保持します。

使用されるplugin で定義される最大傾きが、このプロパティの上限となります。plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは89.5 になります。

QtLocation 5.12以降、プラグインはさらに、現在のズーム・レベルに応じてこの値を制限することができます。

このプロパティは QtLocation 5.9 で導入されました。

tilt およびminimumTiltも参照してください 。

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

最大ズームレベルは、使用されるplugin によって定義されます。plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは30 になります。

このプロパティは、マップの最小有効視野を度単位で保持します。

使用されるplugin による最小傾斜視野が、このプロパティの下界となる。plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは1 になります。

このプロパティは QtLocation 5.9 で導入されました。

fieldOfView およびmaximumFieldOfViewも参照してください 。

このプロパティは、マップの有効な傾きの最小値を度単位で保持します。

使用されるplugin で定義される最小傾きは、このプロパティの下界となります。plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは0 になります。

QtLocation 5.12以降、プラグインはさらに、現在のズーム・レベルに応じてこの値を制限することができます。

このプロパティは QtLocation 5.9 で導入されました。

tilt およびmaximumTiltも参照してください 。

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

使用されるplugin で定義される最小ズームレベルが、このプロパティの下限です。しかし、返される値はキャンバスのサイズにも依存し、マップがビューポートより小さくなるのを防ぐために、ユーザが指定した値や、使用されているプラグインによって定義された最小ズームレベルより高くすることができます。

plugin プロパティが設定されていないか、プラグインがマッピングをサポートしていない場合、このプロパティは0 。

このプロパティは、マッピング機能を提供するプラグインを保持する。

これはライトワンス・プロパティです。一旦マップにプラグインが関連付けられると、プラグインを変更しようとしても無視されます。

この読み取り専用プロパティは、このマップがサポートするmap types のセットを保持します。

activeMapTypeも参照してください 。

このプロパティはマップの傾きを度単位で保持します。この値の有効範囲は [minimumTilt,maximumTilt ] です。マップに使用されているプラグインが傾きをサポートしていない場合、このプロパティを変更しても効果はありません。

このプロパティは QtLocation 5.9 で導入されました。

minimumTilt とmaximumTiltも参照して ください。

このプロパティは Map QML 要素内の可視領域を保持します。このプロパティの座標は Map 要素からの相対座標です。そのサイズは Map 要素のサイズにクランプされます。null の visibleArea は Map 全体が可視であることを意味する。

このプロパティは、マップのビューポートを占める領域を保持します。カメラはシェイプの中心に配置され、シェイプ全体がスクリーンに表示されるように、可能な限り最大の積分ズーム・レベルに設定されます。これは、このプロパティが設定された直後にこのプロパティを読み返すと、返される領域が設定された領域と等しいか大きくなることを意味する。

このプロパティを設定すると、マップのcenter とzoomLevel が暗黙のうちに変更されます。これらのプロパティに以前に設定された値は上書きされます。

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

ズーム・レベルの値が大きいほど、詳細が表示されます。ズーム・レベルは常に負ではありません。デフォルト値は8.0です。使用するプラグインによっては、タイルが利用可能な範囲を表す [minimumZoomLevel,maximumZoomLevel] の範囲外の値が受け入れられるか、クランプされる場合があります。

このシグナルは、ユーザーが著作権表示のlink をクリックしたときに発せられます。アプリケーションは、ブラウザでリンクを開くか、その内容をユーザーに表示する必要があります。

指定されたitem を Map に追加します（例：MapQuickItem,MapCircle ）。オブジェクトがすでにマップ上にある場合、再度追加されることはありません。

例として、現在位置を表すMapCircle がある場合を考えてみましょう：

import QtQuick
import QtPositioning
import QtLocation

PositionSource {
    id: positionSource
}

Map {
    id: map
    property MapCircle circle

    Component.onCompleted: {
        circle = Qt.createQmlObject('import QtLocation; MapCircle {}', page)
        circle.center = positionSource.position.coordinate
        circle.radius = 5000.0
        circle.color = 'green'
        circle.border.width = 3
        map.addMapItem(circle)
    }
}

mapItems 、removeMapItem 、およびclearMapItemsも参照してください 。

与えられたitemGroup に含まれるマップアイテムをマップに追加します（例：MapQuickItem,MapCircle ）。

MapItemGroup およびremoveMapItemGroupも参照して ください。

itemView をマップに追加します。

MapItemView およびremoveMapItemViewも参照して ください。

coordinate をpoint に整列させます。 このメソッドは、center qml プロパティによって提供される機能を効果的に拡張し、Map 要素の中心以外の点に座標を整列させることができます。これは、シーンの中心（例えば、カーソル）がマップの中心に正確に配置されないようなアプリケーションで便利です。

マップが傾いていて、coordinate がカメラの後ろにある場合、またはマップの準備ができていない場合（mapReady を参照）、このメソッドを呼び出しても効果はありません。

この API の Qt 5.10 でのリリースは技術プレビューです。

centerも参照してください 。

現在選択されているプラグインによって収集されたマップデータをクリアします。

plugin も参照して ください。

マップからすべてのアイテムとアイテム グループを削除します。

mapItems,addMapItem,removeMapItem,addMapItemGroup,removeMapItemGroupも参照して ください。

ビューポートを特定のジオ形状に合わせるgeoShape 。margins の単位はスクリーンピクセルです。

visibleRegionも参照してください 。

引数を指定しない場合は、現在のビューポートをすべてのマップアイテムの境界にフィットさせます。カ メ ラ は、 マ ッ プ項目の中央に位置 し 、 すべてのマ ッ プ項目が画面に表示で き る最大の積分倍率で配置 さ れます。items が指定された場合、現在のビューポートを指定されたマップアイテムの境界にのみ合わせる。

fitViewportToVisibleMapItemsも参照してください 。

現在のビューポートを、表示されているすべてのマップアイテムの境界に合わせます。カメラはマップアイテムの中央に配置され、すべてのマップアイテムが画面に表示されるように、可能な限り最大の積分ズームレベルで配置されます。

fitViewportToMapItemsも参照してください 。

coordinate に対応するマップアイテムからの相対位置を返す。

clipToViewPort がtrue の場合、またはcoordinate が現在のビューポート内にない場合は、無効なQPointF を返す。

x 軸に沿ってdx ピクセル、y 軸に沿ってdy ピクセル、マップのパンニングを開始する。

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

パンしている間、center 、zoomLevel は変化することがある。

オプ シ ョ ン ヒ ン ト ： こ のア イ ド ル期間中にマ ッ プがプ リ フ ェ ッ チで き る よ う にす る 。

与えられたitem をマップから削除します（例えばMapQuickItem,MapCircle ）。MapItem が存在しないか、以前にマップに追加されていない場合、このメソッドは何もしない。

mapItems 、addMapItem 、およびclearMapItemsも参照してください 。

itemGroup およびその中に含まれるアイテムをマップから削除します。

MapItemGroup およびaddMapItemGroup も参照して ください。

itemView およびそれによってインスタンス化されたアイテムをマップから削除します。

MapItemView およびaddMapItemView も参照して ください。

マップの方位をbearing に設定し、coordinate を中心に回転させます。マップに使用されているプラグインが方位をサポートしている場合、bearing の有効範囲は 0 ～ 360 です。マップに使用されているプラグインが方位をサポートしていない場合、マップが傾いていてcoordinate がカメラの後ろにある場合、またはマップの準備ができていない場合（mapReady を参照）、このメソッドを呼び出しても効果はありません。

この API の Qt 5.10 でのリリースは技術プレビューです。

マップアイテムからの相対座標position に対応する座標を返します。

clipToViewPort がtrue の場合、またはposition が現在のビューポート内にない場合は、無効な座標を返します。