Durchsuchen einer Tabelle nach Features an einem Punkt
Beschreibung
Durchsucht eine benannte Tabelle in der Datenbank nach Features, die sich innerhalb einer bestimmten Toleranz an einem bestimmten Punkt befinden. 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 „searchAtPoint“-Methode:
- Gibt eine Feature-Sammlung mit den Attributen zurück.
- Gibt die Entfernung in der Einheit zurück, die in der Toleranz angegeben wurde.
- Gibt Ergebnisse standardmäßig nach Entfernung sortiert zurück (nächstgelegene zuerst)
- Das Attribut „q“ muss vom Abfragetyp „searchAtPoint“ sein.
- Wenn Sie den Attribut- und den „orderBy“-Matrixparameter angeben, können Sie mithilfe einer durch Kommata getrennten Liste mehrere Angaben machen.
- Der Standardtoleranzradius beträgt 300 Meter.
- 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 sich innerhalb einer bestimmten Toleranz an einem bestimmten Punkt befinden, benötigt der Benutzer (oder alle Rollen, zu denen er gehört) wie folgt die Ausführungsberechtigung für die benannten Tabellen:
- „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=searchAtPoint&point=point,srs&[tolerance=distance unit]
&destinationSrs&[geometryAttributeName=geomname]
&[page=pagenumber]&[pageLength=pagelength]
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=searchAtPoint | Zeichenfolge | ja | Die durchzuführende Abfragemethode. Dies muss searchAtPoint sein. |
| point=point,srs | Zeichenfolge | ja | Der Punkt, der bei der Suche als Startpunkt verwendet wird. Der Punkt muss die X/Y-Positionen und das räumliche Referenzsystem für die Geometrie enthalten. Beispiel: point = -75.651157,45.374245,EPSG:4326 |
| tolerance=distance unit | Zeichenfolge | no | Die Entfernung für die Suche im Umfeld des Punkts. Die Toleranz beträgt standardmäßig 300 Meter. Wenn die Toleranz 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). |
| 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). |
| 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. |
| 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. |
Gibt zurück:
Gibt Metadaten für eine benannte Tabelle im Repository zurück.
Beispiele
Gibt die Hauptstädte der Welt zurück, die in einem Umkreis von 1.000 Meilen zum angegebenen Punkt liegen. Alle Attribute für Features, die in der „WorldcapTable“ gefunden wurden, werden zurückgegeben.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/
features.json?q=searchAtPoint&point=-75.651157,45.374245,EPSG%3A4326&tolerance=1000%20mi
Gibt die Hauptstädte der Welt zurück, die in einem Umkreis von 500 Meilen zum angegebenen Punkt liegen. Nur die Attribute „Country“ und „Cap_Pop“ für Features, die in der „WorldcapTable“ gefunden wurden, werden zurückgegeben.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/
features.json;attributes=Country,Cap_Pop?q=searchAtPoint&point=-75.651157,45.374245,
EPSG%3A4326&tolerance=500%20mi&destinationSrs=epsg:3857
Gibt die Hauptstädte der Welt zurück, die in einem Umkreis von 500 Meilen zum angegebenen Punkt liegen. Nur das Attribut „Country“ wird für Features zurückgegeben, die in der „WorldcapTable“ gefunden wurden, und in absteigender Reihenfolge sortiert.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/features.json;
attributes=Country;orderBy=Country%20D?q=searchAtPoint&point=-75.651157,45.374245,
EPSG%3A4326&tolerance=500%20mi