Búsqueda de las características más cercanas a una geometría en una tabla
Descripción
Busca las funciones que están más cercanas a una geometría especificada, dentro de una cierta distancia, en una tabla con nombre asignado al interior del repositorio. Tiene las opciones de devolver todos los datos de atributos, datos de atributos específicos y ordenar los datos arrojados por un atributo. Estas son algunas reglas básicas para el método searchNearest:
- Arroja una colección de características junto con los atributos.
- Arroja un valor de distancia en la respuesta mediante el uso del parámetro distanceAttributeName especificado en la solicitud.
- Devuelve la distancia en la unidad especificada en el parámetro .
- Arroja los resultados, de forma predeterminada, en orden del más cercano al más alejado
- El atributo q debe ser del tipo de consulta searchNearest.
- La cantidad máxima de funciones arrojadas se define mediante el uso del parámetro en la solicitud o al usar el parámetro en la configuración de Feature Service. De manera predeterminada, este valor es de 1000 características.
- Al especificar el atributo y los parámetros de orderBy Matrix, puede indicar más de uno mediante el uso de una lista separada por coma.
- Al usar el parámetro de matriz orderBy, debe especificar la dirección de orden como D para descendente o A para ascendente.
En esta operación se devuelve una recopilación de funciones JSON que se pueden traspasar a una solicitud para generar mapa o generar leyenda en Mapping Service.
Flujo de autorización de ACL
Para buscar características de una tabla con nombre asignado dentro del repository que están más cercanas a una geometría especificada, dentro de una cierta distancia, será necesario que el usuario (o las funciones a las que pertenezca) ejecute los permisos en la tabla con nombre asignado de la siguiente manera:
- "EJECUTAR" para el tipo de entidad "Location Intelligence.Named Resources"
Formato de dirección URL de HTTP GET
El siguiente formato se utiliza para solicitudes HTTP GET:
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]
Parámetros
Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| tablename | Cadena | sí | El nombre de la tabla para arrojar los metadatos. La tabla se especifica mediante un regex para la tabla con nombre asignado que se va a generar, a partir de la ubicación de la tabla con nombre asignado en el repositorio. El nombre de la tabla con nombre asignado se define entre la parte /tables de la dirección URL y la parte /metadatarep de la misma. El nombre de la tabla con nombre asignado se define entre la parte /tables de la dirección URL y la parte /metadatarep de la misma..../FeatureService/tables/Samples/NamedTables /WorldTable/metadata.json;... |
| rep | Cadena | sí | La representación que se va a arrojar. La representación compatible es . |
| attributes=attname | Cadena | no | Los nombres de atributo en la tabla que se van a arrojar en la respuesta. De manera predeterminada, se arrojan todos los atributos. Más de un atributo se define mediante una lista separada por coma. Esta es una manera simple de limitar la cantidad de información en la respuesta, para incluir solo la información requerida. Cada característica en la colección de características resultante solo incluirá los atributos especificados. Por ejemplo, si la tabla solo contiene cuatro atributos, pero se requieren solo dos en la respuesta, dichos dos nombres de atributos se pueden especificar aquí (separados por coma) y los valores de los otros no se arrojarán. |
| orderBy=attname dir | Cadena | no | El nombre del atributo y la dirección para ordenar los resultados arrojados. De manera predeterminada, los resultados se ordenan en orden del más cercano al más alejado, según la distancia desde el punto especificado. Al especificar un atributo para ordenar los resultados, debe incluir el nombre del atributo y la dirección de orden (A para ascendente (bajo a alto) o D para descendente (alto a bajo)). |
| q=searchNearest | Cadena | sí | El método de consulta que se va a realizar. Debe ser . |
| geometría = geom,srs | Cadena | sí | La geometría que se usa como ubicación de inicio para la búsqueda. La geometría debe incluir el tipo de geometría, las coordenadas y el sistema de referencia espacial de la geometría. Por ejemplo: 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"}}}
Nota: Si no se especifica una propiedad CRS, entonces EPSG:4326 se considera como CRS predeterminado.
|
| withinDistance= distanceunit |
Cadena | no | La distancia a buscar alrededor de la geometría. Cuando se especifica, la distancia debe incluir el valor y la unidad de distancia. Los valores de distancia que se arrojan en la respuesta estarán en las unidades especificadas en la solicitud (la unidad predeterminada es metros). |
| distanceAttributeName= geomname |
Cadena | no | El nombre del atributo de distancia que se va a arrojar en la respuesta. Este atributo se usa para arrojar el valor de distancia desde la geometría hacia las características más cercanas encontradas. Si no se especifica el parámetro , en la respuesta no se arrojará el valor de distancia hacia cada característica. |
| geometryAttributeName= geomname |
Cadena | no | El atributo de definición de geometría desde la tabla que se debe usar para procesar la consulta espacial. La consulta de actualización a realizar, en formato MI SQL. |
| destinationSrs | Cadena | no | El sistema de coordenadas devuelve las geometrías resultantes. El valor predeterminado es el sistema de coordenadas de los datos que se utilizan (por ejemplo: epsg:4326). |
| page=pagenumber | Cadena | no | El número de página que se va a arrojar. |
| pageLength=pagelength | Cadena | no | La cantidad de características arrojadas en cada página. Si se especifica el parámetro página en la solicitud, debe definir pageLength. |
| maxFeatures= maxfeatures |
Cadena | no | La cantidad total de características arrojadas en la respuesta. Si no se especifica el parámetro maxFeatures en la solicitud, se usa el parámetro maxCandidates en la configuración de Feature Service. De manera predeterminada, este valor es de 1000 características. |
| tablePointAttributeName=tblPointName | Cadena | no | Devuelve el punto más cercano en la geometría de la tabla de la búsqueda. Especifica el nombre de un atributo adicional que se añadirá a la respuesta que contiene el punto más cercano en la geometría desde la tabla, de la distancia mínima hacia la geometría de la solicitud especificada. Si esto no se especifica, no se añadirá atributo alguno. |
| geomPointAttributeName=geomPointAttributeName | Cadena | no | Devuelve el punto más cercano en la geometría de la solicitud. Especifica el nombre de un atributo adicional que se añadirá a la respuesta que contiene un punto en la geometría de la solicitud especificada, de la distancia mínima hacia la geometría desde la tabla de la búsqueda. Si esto no se especifica, no se añadirá atributo alguno. |
Devolución
Arroja los metadatos de una tabla con nombre asignado en el repositorio.
Ejemplos
Arroja las capitales mundiales más cercanas que se encuentran dentro de una distancia de 5000 millas (8047 km) desde la geometría del punto especificado.
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
Arroja las tres capitales estatales más cercanas en EE.UU. que están dentro de una distancia de 5000 (8047 km) desde la geometría especificada.
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
Devuelve las tres capitales estatales más cercanas en EE.UU. que están dentro de una distancia de 1000 millas desde la geometría del punto especificado. La distancia hacia cada característica se arrojará en el atributo withinDistanceFromGeometry en la respuesta y el cálculo se realizará a partir de las geometrías en la columna GEOLOC en la tabla con nombre asignado 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">