Map QML Type

Zugriff auf die aktuell aktive map type.

Diese Eigenschaft kann gesetzt werden, um die aktive map type zu ändern. Siehe die Eigenschaft supportedMapTypes für mögliche Werte.

Siehe auch mapType.

Diese Eigenschaft enthält die Peilung für die Karte. Der Standardwert ist 0. Wenn das für die Karte verwendete Plugin die Peilung unterstützt, liegt der gültige Bereich für diesen Wert zwischen 0 und 360. Wenn das für die Karte verwendete Plugin keine Peilung unterstützt, hat die Änderung dieser Eigenschaft keine Auswirkungen.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Diese Eigenschaft enthält die Koordinate, die das Zentrum des Mapping-Viewports einnimmt. Ungültige Zentralkoordinaten werden ignoriert.

Der Standardwert ist eine beliebige gültige Koordinate.

Diese Eigenschaft enthält die Hintergrundfarbe des Kartenelements.

Diese Eigenschaft bestimmt die Sichtbarkeit des Copyrighthinweises. Der Hinweis wird normalerweise in der linken unteren Ecke angezeigt. Standardmäßig ist diese Eigenschaft auf true eingestellt.

Diese schreibgeschützte Eigenschaft enthält den zuletzt aufgetretenen Fehler des Mapping-Dienstanbieters.

• Karte.NoError - Es ist kein Fehler aufgetreten.
• Map.NotSupportedError -Die Maps-Plugin-Eigenschaft wurde nicht gesetzt oder es ist kein Mapping-Manager mit dem Plugin verbunden.
• Map.UnknownParameterError - Das Plugin hat einen der ihm übergebenen Parameter nicht erkannt.
• Map.MissingRequiredParameterError - Das Plugin hat einen der Parameter, die es erwartet, nicht gefunden.
• Map.ConnectionError - Das Plugin konnte keine Verbindung zu seinem Backend-Dienst oder seiner Datenbank herstellen.

Siehe auch QGeoServiceProvider::Error.

Diese schreibgeschützte Eigenschaft enthält die textuelle Darstellung des letzten Fehlers des Mapping-Providers. Wenn kein Fehler aufgetreten ist, wird ein leerer String zurückgegeben.

Eine leere Zeichenkette kann auch zurückgegeben werden, wenn ein Fehler aufgetreten ist, der keine zugehörige textuelle Darstellung hat.

Siehe auch QGeoServiceProvider::errorString().

Diese Eigenschaft enthält das Sichtfeld der Kamera, die zur Betrachtung der Karte verwendet wird, in Grad. Wenn die Plugin-Eigenschaft der Karte nicht gesetzt ist oder das Plugin kein Mapping unterstützt, ist der Wert 45 Grad.

Beachten Sie, dass eine Änderung dieses Wertes implizit auch den Abstand zwischen der Kamera und der Karte ändert, so dass bei einem Neigungswinkel von 0 Grad das resultierende Bild für jeden für diese Eigenschaft verwendeten Wert identisch ist.

Weitere Informationen zu diesem Parameter finden Sie in den Wikipedia-Artikeln über Field of view und Angle of view.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch minimumFieldOfView und maximumFieldOfView.

Gibt die Liste aller Kartenelemente in beliebiger Reihenfolge zurück. Diese Elemente umfassen sowohl Elemente, die statisch als Teil der Typdeklaration deklariert wurden, als auch dynamische Elemente (addMapItem, MapItemView).

Siehe auch addMapItem, removeMapItem, und clearMapItems.

Diese Eigenschaft gibt an, ob die Map erfolgreich initialisiert wurde und bereit ist, verwendet zu werden. Einige Methoden, wie z.B. fromCoordinate und toCoordinate, funktionieren erst, wenn die Karte bereit ist. Aufgrund der Architektur von Map ist es ratsam, das Signal, das für diese Eigenschaft ausgegeben wird, anstelle von Component.onCompleted zu verwenden, um sicherzustellen, dass sich alles wie erwartet verhält.

Diese Eigenschaft enthält das maximal gültige Sichtfeld für die Karte in Grad.

Der minimale Neigungswinkel des Sichtfeldes von plugin ist eine Obergrenze für diese Eigenschaft. Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, lautet diese Eigenschaft 179.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch fieldOfView und minimumFieldOfView.

Diese Eigenschaft gibt die maximal zulässige Neigung für die Karte in Grad an.

Die maximale Neigung, die durch die plugin definiert ist, stellt eine obere Grenze für diese Eigenschaft dar. Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, lautet diese Eigenschaft 89.5.

Seit QtLocation 5.12 können Plugins diesen Wert zusätzlich in Abhängigkeit von der aktuellen Zoomstufe einschränken.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch tilt und minimumTilt.

Diese Eigenschaft enthält die maximal zulässige Zoomstufe für die Karte.

Die maximale Zoomstufe wird durch das verwendete plugin definiert. Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, ist diese Eigenschaft 30.

Diese Eigenschaft enthält das minimal gültige Sichtfeld für die Karte in Grad.

Das minimale geneigte Sichtfeld des verwendeten plugin ist eine untere Grenze für diese Eigenschaft. Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, ist diese Eigenschaft 1.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch fieldOfView und maximumFieldOfView.

Diese Eigenschaft enthält die minimale gültige Neigung für die Karte in Grad.

Die minimale Neigung, die durch die plugin definiert ist, stellt eine untere Grenze für diese Eigenschaft dar. Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, lautet diese Eigenschaft 0.

Seit QtLocation 5.12 können Plugins diesen Wert zusätzlich in Abhängigkeit von der aktuellen Zoomstufe einschränken.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch tilt und maximumTilt.

Diese Eigenschaft enthält die minimale gültige Zoomstufe für die Karte.

Die minimale Zoomstufe, die durch die plugin definiert ist, stellt eine untere Grenze für diese Eigenschaft dar. Der zurückgegebene Wert ist jedoch auch von der Größe der Leinwand abhängig und kann höher sein als der vom Benutzer angegebene Wert oder als die vom verwendeten Plugin definierte Mindestzoomstufe, um zu verhindern, dass die Karte in einer der beiden Dimensionen kleiner als das Ansichtsfenster ist.

Wenn die Eigenschaft plugin nicht gesetzt ist oder das Plugin kein Mapping unterstützt, lautet diese Eigenschaft 0.

Diese Eigenschaft enthält das Plugin, das die Mapping-Funktionalität bereitstellt.

Dies ist eine einmalig beschreibbare Eigenschaft. Sobald die Karte mit einem Plugin verknüpft ist, werden alle Änderungsversuche des Plugins ignoriert.

Diese schreibgeschützte Eigenschaft enthält den Satz von map types, der von dieser Karte unterstützt wird.

Siehe auch activeMapType.

Diese Eigenschaft enthält die Neigung der Karte in Grad. Der Standardwert ist 0. Der gültige Bereich für diesen Wert ist [ minimumTilt, maximumTilt ]. Wenn das für die Karte verwendete Plugin keine Neigung unterstützt, hat die Änderung dieser Eigenschaft keine Auswirkungen.

Diese Eigenschaft wurde in QtLocation 5.9 eingeführt.

Siehe auch minimumTilt und maximumTilt.

Diese Eigenschaft enthält den sichtbaren Bereich innerhalb des Map QML-Elements. Es handelt sich um ein Rect, dessen Koordinaten relativ zum Map-Element sind. Seine Größe wird auf die Größe des Map-Elements geklemmt. Eine Null visibleArea bedeutet, dass die gesamte Karte sichtbar ist.

Diese Eigenschaft enthält den Bereich, der das Sichtfenster der Karte einnimmt. Die Kamera wird in der Mitte der Form positioniert, und zwar in der größtmöglichen integralen Zoomstufe, so dass die gesamte Form auf dem Bildschirm sichtbar ist. Dies bedeutet, dass der zurückgegebene Bereich gleich oder größer als der eingestellte Bereich ist, wenn diese Eigenschaft kurz nach ihrer Einstellung zurückgelesen wird.

Das Setzen dieser Eigenschaft ändert implizit die center und zoomLevel der Karte. Jeder zuvor gesetzte Wert für diese Eigenschaften wird überschrieben.

Diese Eigenschaft enthält die Zoomstufe für die Karte.

Größere Werte für die Zoomstufe bieten mehr Details. Zoomstufen sind immer nicht-negativ. Der Standardwert ist 8.0. Je nach verwendetem Plugin können Werte außerhalb des Bereichs [minimumZoomLevel, maximumZoomLevel], der den Bereich darstellt, für den Kacheln verfügbar sind, akzeptiert oder eingegrenzt werden.

Dieses Signal wird ausgegeben, wenn der Benutzer auf eine link in der Copyright-Notiz klickt. Die Anwendung sollte den Link in einem Browser öffnen oder dem Benutzer seinen Inhalt anzeigen.

Fügt das angegebene item zur Map hinzu (zum Beispiel MapQuickItem, MapCircle). Wenn das Objekt bereits in der Map enthalten ist, wird es nicht erneut hinzugefügt.

Betrachten Sie als Beispiel den Fall, dass Sie ein MapCircle haben, das Ihre aktuelle Position darstellt:

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)
    }
}

Siehe auch mapItems, removeMapItem, und clearMapItems.

Fügt die in der angegebenen itemGroup enthaltenen Kartenelemente zur Karte hinzu (z. B. MapQuickItem, MapCircle).

Siehe auch MapItemGroup und removeMapItemGroup.

Fügt itemView zur Map hinzu.

Siehe auch MapItemView und removeMapItemView.

Richtet coordinate an point aus. Diese Methode erweitert die Funktionalität der qml-Eigenschaft center und ermöglicht es, eine Koordinate an einem anderen Punkt des Kartenelements als seinem Mittelpunkt auszurichten. Dies ist in Anwendungen nützlich, bei denen der Mittelpunkt der Szene (z. B. ein Cursor) nicht genau in der Mitte der Karte platziert werden soll.

Wenn die Karte gekippt ist und coordinate sich hinter der Kamera befindet, oder wenn die Karte nicht bereit ist (siehe mapReady), hat der Aufruf dieser Methode keine Wirkung.

Die Veröffentlichung dieser API mit Qt 5.10 ist eine Technologievorschau.

Siehe auch center.

Löscht die vom aktuell ausgewählten Plugin gesammelten Kartendaten.

Siehe auch plugin.

Entfernt alle Elemente und Elementgruppen aus der Karte.

Siehe auch mapItems, addMapItem, removeMapItem, addMapItemGroup, und removeMapItemGroup.

Passt das Ansichtsfenster an eine bestimmte Geoform an geoShape. Die margins sind in Bildschirm-Pixeln angegeben.

Siehe auch visibleRegion.

Wenn kein Argument angegeben wird, wird das aktuelle Ansichtsfenster an die Begrenzung aller Kartenelemente angepasst. Die Kamera wird in der Mitte der Kartenelemente positioniert, und zwar mit der größtmöglichen integralen Zoomstufe, die es ermöglicht, dass alle Kartenelemente auf dem Bildschirm sichtbar sind. Wenn items angegeben wird, wird das aktuelle Ansichtsfenster nur an die Begrenzung der angegebenen Kartenelemente angepasst.

Siehe auch fitViewportToVisibleMapItems.

Passt das aktuelle Ansichtsfenster an die Begrenzung aller sichtbaren Kartenelemente an. Die Kamera wird in der Mitte der Kartenelemente positioniert, und zwar mit der größtmöglichen integralen Zoomstufe, die es erlaubt, alle Kartenelemente auf dem Bildschirm zu sehen.

Siehe auch fitViewportToMapItems.

Gibt die Position relativ zu dem Kartenelement zurück, das der coordinate entspricht.

Wenn clipToViewPort true ist oder nicht angegeben wird, wird ein ungültiges QPointF zurückgegeben, wenn coordinate nicht innerhalb des aktuellen Ansichtsfensters liegt.

Startet das Schwenken der Karte um dx Pixel entlang der x-Achse und um dy Pixel entlang der y-Achse.

Positive Werte für dx verschieben die Karte nach rechts, negative Werte nach links. Positive Werte für dy verschieben die Karte nach unten, negative Werte nach oben.

Während des Schwenks können sich die center und zoomLevel ändern.

Optionaler Hinweis, der es der Karte erlaubt, während dieser Leerlaufzeit einen Prefetch durchzuführen

Entfernt das angegebene item aus der Map (zum Beispiel MapQuickItem, MapCircle). Wenn das MapItem nicht existiert oder noch nicht zur Map hinzugefügt wurde, führt die Methode nichts aus.

Siehe auch mapItems, addMapItem, und clearMapItems.

Entfernt itemGroup und die darin enthaltenen Elemente aus der Map.

Siehe auch MapItemGroup und addMapItemGroup.

Entfernt itemView und die von ihm instanziierten Elemente aus der Map.

Siehe auch MapItemView und addMapItemView.

Setzt die Peilung für die Karte auf bearing und dreht sie um coordinate. Wenn das für die Karte verwendete Plugin Peilung unterstützt, liegt der gültige Bereich für bearing zwischen 0 und 360. Wenn das für die Karte verwendete Plugin keine Peilung unterstützt, oder wenn die Karte gekippt ist und coordinate zufällig hinter der Kamera liegt, oder wenn die Karte nicht bereit ist (siehe mapReady), hat der Aufruf dieser Methode keine Wirkung.

Die Veröffentlichung dieser API mit Qt 5.10 ist eine Technologievorschau.

Gibt die Koordinate zurück, die der position relativ zum Kartenelement entspricht.

Wenn clipToViewPort true ist oder nicht angegeben wird, wird eine ungültige Koordinate zurückgegeben, wenn position nicht im aktuellen Ansichtsfenster liegt.