Búsqueda de características en un punto de una tabla
Descripción
Busca características que están en un punto específico dentro de cierta tolerancia, 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 searchAtPoint:
- Arroja una colección de características junto con los atributos.
- Arroja la distancia en la unidad especificada en la tolerancia.
- 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 searchAtPoint.
- 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.
- El radio de tolerancia predeterminado es de 300 metros.
- 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.
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=searchAtPoint&point=point,srs&[tolerance=distance unit]
&destinationSrs&[geometryAttributeName=geomname]
&[page=pagenumber]&[pageLength=pagelength]
El json en el POST es opcional; solo se requiere si la consulta SQL utiliza parámetros vinculados.
Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.
| Para obtener más información sobre los tipos de parámetros, consulte . | La operación HTTP DELETE toma el siguiente parámetro de consulta. | Requerido | Descripción |
|---|---|---|---|
| tablename | String | 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;... |
| /WorldTable/features.json;... | String | sí | La representación que se va a arrojar. La representación compatible es json. |
| attributes=attname | String | historicTrafficTimeBucket | 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 | String | historicTrafficTimeBucket | 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. Cuando se especifica un atributo para ordenar los resultados, se 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=searchAtPoint | String | sí | El método de consulta que se va a realizar. Debe ser searchAtPoint. |
| point=point,srs | String | sí | El punto que se usa como ubicación de inicio para la búsqueda. El punto debe incluir las posiciones x/y, y el sistema de referencia espacial para la geometría. Por ejemplo: point=-75.651157,45.374245,EPSG:4326 |
| tolerance=unidad de distancia | String | historicTrafficTimeBucket | La distancia a buscar alrededor del punto. De manera predeterminada la tolerancia es de 300 metros. Cuando se especifica, la tolerancia 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). |
| destinationSrs | String | historicTrafficTimeBucket | 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). |
| geometryAttributeName= geomname |
String | historicTrafficTimeBucket | 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. |
| page=pagenumber | String | historicTrafficTimeBucket | El número de página que se va a arrojar. |
| pageLength= pagelength |
String | historicTrafficTimeBucket | La cantidad de características arrojadas en cada página. Si se especifica el parámetro página en la solicitud, debe definir pageLength. |
Devolución
Arroja los metadatos de una tabla con nombre asignado en el repositorio.
Ejemplos
Arroja las capitales mundiales que se encuentran dentro de una distancia de 1000 millas (1609 km) desde el punto especificado. Se arrojarán todos los atributos de las características que se encuentren en WorldcapTable.
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
Arroja las capitales mundiales que se encuentran dentro de una distancia de 500 millas (805 km) desde el punto especificado. Solo se arrojarán los atributos Country y Cap_Pop de las características que se encuentren en WorldcapTable.
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
Arroja las capitales mundiales que se encuentran dentro de una distancia de 500 millas (805 km) desde el punto especificado. Solo se arrojará el atributo Country, y el orden en dicho atributo será descendente para las características que se encuentren en WorldcapTable.
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