PlaceSearchModel QML Type

Diese Eigenschaft enthält eine Liste von Kategorien, die bei der Suche verwendet werden sollen. Die Suchergebnisse werden für Orte zurückgegeben, die mindestens einer der Kategorien entsprechen.

Diese Eigenschaft enthält die Anzahl der Ergebnisse, die das Modell hat.

Beachten Sie, dass sie sich nicht auf die Gesamtzahl der im Backend verfügbaren Suchergebnisse bezieht. Die Gesamtzahl der Suchergebnisse wird derzeit von der API nicht unterstützt.

Diese Eigenschaft enthält eine Reihe von Parametern, die verwendet werden, um festzulegen, wie die Orte der Suchergebnisse den Favoriten in favoritesPlugin zugeordnet werden.

Standardmäßig ist die Parameter-Map leer und impliziert, dass das Favoriten-Plugin nach alternativen Bezeichnern abgleicht. Im Allgemeinen braucht ein Anwendungsentwickler diese Eigenschaft nicht zu setzen.

In Fällen, in denen das Favoriten-Plugin den Abgleich nach alternativen Bezeichnern nicht unterstützt, sollte die Plugin-Dokumentation konsultiert werden, um genau zu erfahren, welche Schlüssel-Wert-Parameter zu setzen sind.

Diese Eigenschaft enthält die Plugin, die für die Suche nach Favoriten verwendet wird. Für alle Orte aus der Suche, die im favoritesPlugin mit Querverweisen oder Übereinstimmungen versehen werden können, wird die Eigenschaft favorite auf die entsprechende Place aus dem favoritesPlugin gesetzt.

Wenn das favoritesPlugin nicht gesetzt ist, wird die favorite Eigenschaft der Orte in den Ergebnissen immer Null sein.

Siehe auch Favorites.

Diese Eigenschaft steuert, wie sich das Paging auf PlaceSearchModel auswirkt. Bei true wird durch den Aufruf von previousPage oder nextPage das Modell nicht zurückgesetzt, sondern es werden neue Ergebnisse an das Modell angehängt. Die Voreinstellung ist false.

Diese Eigenschaft wurde in QtLocation 5.12 eingeführt.

Diese Eigenschaft enthält die Grenze für die Anzahl der Elemente, die zurückgegeben werden.

Diese Eigenschaft gibt an, ob eine oder mehrere zusätzliche Seiten mit Suchergebnissen verfügbar sind.

Siehe auch nextPage().

Diese Eigenschaft enthält die Plugin, die für die Durchführung der Suche verwendet wird.

Diese Eigenschaft gibt an, ob eine oder mehrere vorherige Seiten mit Suchergebnissen verfügbar sind.

Siehe auch previousPage().

Diese Eigenschaft enthält die placeId, die verwendet wird, um Empfehlungen für ähnliche Orte zu finden.

Diese Eigenschaft enthält einen Relevanz-Hinweis, der in der Suchanfrage verwendet wird. Der Hinweis wird dem Anbieter gegeben, um die Rangfolge der Ergebnisse zu unterstützen, aber nicht zu diktieren. Beispielsweise kann der Hinweis auf die Entfernung näher gelegenen Orten einen höheren Rang geben, was aber nicht unbedingt bedeutet, dass die Ergebnisse streng nach der Entfernung geordnet werden. Ein Anbieter kann den Hinweis gänzlich ignorieren.

Diese Eigenschaft enthält den Suchbereich. Das vom Modell zurückgegebene Suchergebnis wird innerhalb des Suchbereichs liegen.

Wenn diese Eigenschaft auf geocircle gesetzt ist, kann die Eigenschaft radius nicht gesetzt werden. In diesem Fall wählt Plugin einen geeigneten Radius für die Suche.

Die Unterstützung für die Angabe eines Suchbereichs kann je nach der plugin Backend-Implementierung variieren. Einige unterstützen beispielsweise nur einen Suchmittelpunkt, während andere nur Georechtecke unterstützen.

Diese Eigenschaft enthält den in der Abfrage verwendeten Suchbegriff. Der Suchbegriff ist eine Freiform-Textzeichenfolge.

Diese Eigenschaft enthält den Status des Modells. Sie kann einer der folgenden Werte sein:

Diese Eigenschaft enthält den Sichtbarkeitsbereich der zu suchenden Orte. Nur Orte mit der angegebenen Sichtbarkeit werden in den Suchergebnissen wiedergegeben.

Der Sichtbarkeitsbereich kann einer der folgenden sein:

Bricht einen laufenden Suchvorgang sofort ab und setzt den Modellstatus auf PlaceSearchModel.Ready. Das Modell behält alle Suchergebnisse, die es vor dem Start des Vorgangs hatte.

Wenn ein Vorgang nicht im Gange ist, hat der Aufruf von cancel() keine Wirkung.

Siehe auch update() und status.

Gibt die Daten für ein bestimmtes role in der angegebenen Zeile index zurück.

Diese schreibgeschützte Eigenschaft enthält die textuelle Darstellung des letzten Fehlers im Modell der Ortssuche. Wenn kein Fehler aufgetreten ist oder das Modell gelöscht wurde, wird eine leere Zeichenfolge zurückgegeben.

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

Aktualisiert das Modell, um die nächste Seite der Suchergebnisse anzuzeigen. Wenn es keine nächste Seite gibt, führt diese Methode nichts aus.

Aktualisiert das Modell, um die vorherige Seite der Suchergebnisse anzuzeigen. Wenn es keine vorherige Seite gibt, tut diese Methode nichts.

Setzt das Modell zurück. Alle Suchergebnisse werden gelöscht, alle ausstehenden Anfragen werden abgebrochen und mögliche Fehler werden gelöscht. Der Modellstatus wird auf PlaceSearchModel.Null gesetzt.

Aktualisiert das Modell auf der Grundlage der angegebenen Abfrageparameter. Das Modell wird mit einer Liste von Orten gefüllt, die den in den Eigenschaften des Typs angegebenen Suchparametern entsprechen. Die Suchkriterien werden durch die Einstellung von Eigenschaften wie searchTerm, categories, searchArea und limit festgelegt. Die Unterstützung für diese Eigenschaften kann je nach plugin variieren. update() übergibt dann den Satz von Kriterien zur Verarbeitung an plugin.

Während der Aktualisierung des Modells wird status des Modells auf PlaceSearchModel.Loading gesetzt. Bei erfolgreicher Aktualisierung des Modells wird status auf PlaceSearchModel.Ready gesetzt, während bei erfolglosem Abschluss status auf PlaceSearchModel.Error gesetzt und das Modell gelöscht wird.

PlaceSearchModel {
    id: model
    plugin: backendPlugin
    searchArea: QtPositioning.circle(QtPositioning.coordinate(10, 10))
    ...
}

MouseArea {
    ...
    onClicked: {
        model.searchTerm = "pizza";
        model.categories = null;  //not searching by any category
        model.searchArea.center.latitude = -27.5;
        model.searchArea.center.longitude = 153;
        model.update();
    }
}

Siehe auch cancel() und status.

Aktualisiert das Modell basierend auf dem ProposedSearchResult unter dem Index proposedSearchIndex. Das Modell wird mit einer Liste von Orten aufgefüllt, die der vorgeschlagenen Suche entsprechen. Der Modellstatus wird auf PlaceSearchModel.Loading gesetzt. Wenn das Modell erfolgreich aktualisiert wurde, wird der Status auf PlaceSearchModel.Ready gesetzt. Wenn ein Fehler auftritt, wird der Status auf PlaceSearchModel.Error gesetzt und das Modell gelöscht.

Wenn proposedSearchIndex nicht auf ein ProposedSearchResult verweist, tut diese Methode nichts.