Durchsuchen einer Tabelle nach Features, die am nächsten an einer Geometrie liegen
Beschreibung
Durchsucht eine benannte Tabelle in der Datenbank nach Features, die innerhalb einer bestimmten Entfernung am nächsten an einer bestimmten Geometrie liegen. Sie haben die Möglichkeit, alle Attributdaten zurückzugeben, bestimmte Attributdaten zurückzugeben und die zurückgegebenen Daten nach einem Attribut zu sortieren. Im Folgenden finden Sie einige grundlegende Regeln für die „searchNearest“-Methode:
- Gibt eine Feature-Sammlung mit den Attributen zurück.
- Gibt den Entfernungswert in der Antwort mithilfe des in der Anforderung angegebenen Parameters distanceAttributeName zurück.
- Gibt die Entfernung in der Einheit zurück, die im Parameter withinDistance angegeben wurde.
- Gibt Ergebnisse standardmäßig nach Entfernung sortiert zurück (nächstgelegene zuerst)
- Das Attribut „q“ muss vom Abfragetyp „searchNearest“ sein.
- Die maximale Anzahl der zurückgegebenen Features wird mit dem Parameter maxFeatures in der Anforderung oder mit dem Parameter maxCandidates in der Feature-Dienst-Konfiguration definiert. Standardmäßig ist dieser Wert auf 1.000 Features festgelegt.
- Wenn Sie den Attribut- und den „orderBy“-Matrixparameter angeben, können Sie mithilfe einer durch Kommata getrennten Liste mehrere Angaben machen.
- Wenn Sie den „orderBy“-Matrixparameter verwenden, müssen Sie als Sortierreihenfolge entweder „D“ für absteigend („descending“) oder „A“ für aufsteigend („ascending“) angeben.
Dieser Vorgang gibt ein Feature-Sammlungs-JSON zurück, das an eine Render-Karten- oder Render-Legendenanforderungen im Mapping-Dienst weitergeleitet werden kann.
ACL-Autorisierungsfluss
Um eine benannte Tabelle im Repository nach Features zu durchsuchen, die einer bestimmten Geometrie, in einer bestimmten Entfernung, am nächsten sind, benötigt der Benutzer (oder alle Rollen, zu denen er gehört) wie folgt die Ausführungsberechtigung für die benannte Tabelle:
- „EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“
URL-Format von HTTP-GET-Anforderungen
Das folgende Format wird für HTTP-GET-Anforderungen verwendet:
HTTP GET /tables/tablename/features.rep;[attributes=attname];[orderBy=attname dir]
?q=searchNearest&geometry=geom,srs&[withinDistance=distance unit]
&[distanceAttributeName=distanceAttributeName]&[geometryAttributeName=geomname]
&destinationSrs&[page=pagenumber]&[pageLength=pagelength]
&[maxFeatures=maxfeatures]
Parameter
Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tablename | Zeichenfolge | ja | Der Name der Tabelle, die Metadaten zurückgeben soll. Die Tabelle wird durch einen Regex für die benannte Tabelle angegeben, um basierend auf dem Speicherort der benannten Tabelle in der Datenbank zu rendern. Der Name der benannten Tabelle wird zwischen dem „/tables“-Teil der URL und dem „/metadata.rep“-Teil der URL definiert. Zum Zurückgeben der Metadaten für eine benannte Tabelle, die sich unter „/Samples/NamedTables/WorldTable“ in der Datenbank befindet, würde beispielsweise folgende URL verwendet:.../FeatureService/tables/Samples/NamedTables /WorldTable/metadata.json;... |
| rep | Zeichenfolge | ja | Die zurückzugebende Darstellung. Die unterstützte Darstellung ist JSON. |
| attributes=attname | Zeichenfolge | no | Die Attributnamen der Tabelle, die in der Antwort zurückgegeben werden sollen. Standardmäßig werden alle Attribute zurückgegeben. Mehr als ein Attribut ist durch eine durch Kommata getrennte Liste definiert. Dies ist eine einfache Möglichkeit, die Informationsmenge in der Antwort so zu beschränken, dass nur die angeforderten Informationen darin enthalten sind. Die einzelnen Features in der resultierenden Feature-Sammlung enthalten nur die angegebenen Attribute. Wenn die Tabelle beispielsweise vier Attribute enthält, in der Antwort jedoch nur zwei Attribute erforderlich sind, können diese zwei Attributnamen hier (getrennt durch ein Komma) angegeben werden, und die Werte für die anderen zwei Attribute werden nicht zurückgegeben. |
| orderBy=attname dir | Zeichenfolge | no | Der Attributname und die Richtung, in der die zurückgegebenen Ergebnisse sortiert werden sollen. Die Ergebnisse werden standardmäßig, basierend auf der Entfernung zu dem angegebenen Punkt, nach Entfernung sortiert (nächstgelegene zuerst). Wenn Sie ein Attribut zum Sortieren der Ergebnisse angeben, müssen Sie den Attributnamen und die Sortierreihenfolge (A für aufsteigend [„ascending“], d. h. von niedrig zu hoch, oder D für absteigend [„descending“], d. h. von hoch zu niedrig) einschließen. |
| q = searchNearest | Zeichenfolge | ja | Die durchzuführende Abfragemethode. Diese muss searchNearest lauten. |
| geometry = geom,srs | Zeichenfolge | ja | Die Geometrie, die bei der Suche als Startpunkt verwendet wird. Die Geometrie muss den Geometrietyp, Koordinaten und das räumliche Referenzsystem für die Geometrie enthalten. Beispiel: geometry = {"type":"Polygon", "coordinates":[[[-96.8,30.5],[-97.7,30.5], [-97.7,29.9],[-96.8,29.9],[-96.8,30.5]]], "crs":{"type":"name", "properties":{"name":"epsg:4231"}}}
Anmerkung: Wenn keine CRS-Eigenschaft angegeben wird, gilt „EPSG:4326“ als Standard-CRS.
|
| withinDistance= EntfernungEinheit |
Zeichenfolge | no | Die Entfernung für die Suche im Umfeld der Geometrie. Wenn die Entfernung angegeben ist, muss sie den Entfernungswert und die Entfernungseinheit umfassen. Die in der Antwort zurückgegebenen Entfernungswerte sind in den in der Anforderung angegebenen Einheiten enthalten (Standardwert sind Meter). |
| distanceAttributeName= geomname |
Zeichenfolge | no | Der Name des Entfernungsattributs, der in der Antwort zurückgegeben werden soll. Dieses Attribut wird für die Rückgabe des Entfernungswertes von der Geometrie zum nächstgelegenen gefundenen Feature verwendet. Wenn der Parameter distanceAttributeName nicht angegeben wird, wird der Entfernungswert zu den einzelnen Features in der Antwort nicht zurückgegeben. |
| geometryAttributeName= geomname |
Zeichenfolge | no | Das Attribut für die Geometriedefinition aus der Tabelle, das für die Verarbeitung der Geodatenabfrage verwendet werden soll. Dieses Attribut ist nur für Tabellen erforderlich, die mehrere Attribute für Geometriedefinitionen enthalten. |
| destinationSrs | Zeichenfolge | no | Das Koordinatensystem für die Rückgabe der resultierenden Geometrien. Standardmäßig wird das Koordinatensystem der Daten verwendet (z. B. epsg:4326). |
| page=pagenumber | Zeichenfolge | no | Die Seitennummer, die zurückgegeben werden soll. |
| pageLength=pagelength | Zeichenfolge | no | Die Anzahl der Features, die auf den einzelnen Seiten zurückgegeben werden. Wenn der Parameter Seite in der Anforderung angegeben ist, müssen Sie pageLength definieren. |
| maxFeatures= maxfeatures |
Zeichenfolge | no | Die Gesamtzahl der in der Antwort zurückgegebenen Features. Wenn der Parameter maxFeatures in der Anforderung nicht angegeben ist, wird der Parameter maxCandidates in der Feature-Dienst-Konfiguration verwendet. Standardmäßig ist dieser Wert auf 1.000 Features festgelegt. |
| tablePointAttributeName=tblPointName | Zeichenfolge | no | Gibt den am nächsten gelegenen Punkt der Geometrie in der durchsuchten Tabelle zurück. Gibt den Namen eines zusätzlichen Attributs an, das zur Antwort hinzugefügt wird und den am nächsten gelegenen Punkt der Geometrie in der Tabelle zur in der Anforderung spezifizierten Geometrie enthält. Falls nicht angegeben, wird kein Attribut hinzugefügt. |
| geomPointAttributeName=geomPointAttributeName | Zeichenfolge | no | Gibt den am nächsten gelegenen Punkt der Geometrie in der Anforderung zurück. Gibt den Namen eines zusätzlichen Attributs an, das zur Antwort hinzugefügt wird und den am nächsten gelegenen Punkt der Geometrie in der Anforderung zur Geometrie in der durchsuchten Tabelle enthält. Falls nicht angegeben, wird kein Attribut hinzugefügt. |
Gibt zurück:
Gibt Metadaten für eine benannte Tabelle im Repository zurück.
Beispiele
Gibt die nächstgelegenen Hauptstädte der Welt zurück, die in einem Umkreis von 5.000 Meilen zur angegebenen Punktgeometrie liegen.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/features.json?
q=SearchNearest&geometry={"type":"Point","coordinates":[-97.672598,30.252092],"crs":
{"type":"name","properties":{"name":"epsg:4231"}}}&withinDistance=5000%20mi
Gibt die drei nächstgelegenen Hauptstädte von Bundesstaaten in den Vereinigten Staaten zurück, die in einem Umkreis von 5.000 Meilen zur angegebenen Geometrie liegen.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/USA_CAPS/features.json?
q=SearchNearest&geometry={"type":"Polygon","coordinates":[[[-96.8,30.5],[-97.7,30.5],
[-97.7,29.9],[-96.8,29.9],[-96.8,30.5]]],"crs":{"type":"name","properties":{"name":"epsg:4231"}}}
&withinDistance=5000%20mi&maxFeatures=3
Gibt die drei nächstgelegenen Hauptstädte von Bundesstaaten in den Vereinigten Staaten zurück, die in einem Umkreis von 1.000 Meilen zur angegebenen Punktgeometrie liegen. Die Entfernung zu den einzelnen Features wird in der Antwort im Attribut „withinDistanceFromGeometry“ zurückgegeben, und die Berechnung basiert auf den Geometrien in der Spalte „GEOLOC“ in der benannten Tabelle „USA_CAPS“.
"http://localhost:8080/rest/Spatial/FeatureService/tables/Samples/
NamedTables/USA_CAPS/features.json?q=SearchNearest&geometry={%22type%22:%22Point%22,%22coordinates%22:
[-97.672598,30.252092],%22crs%22:{%22type%22:%22name%22,%22properties%22:{%22name%22:%22epsg:4231%22}}}
&withinDistance=1000%20mi&maxFeatures=3&
distanceAttributeName=withinDistanceFromGeometry&geometryAttributeName=Obj"
format="json" scope="external">