Búsqueda de características mediante el uso de consultas SQL
Descripción
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.
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 |
---|---|---|---|
rep | Cadena | sí | La representación que se va a arrojar. La representación compatible es json. |
q=consulta MI SQL | Cadena | sí | La consulta que se va 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. |
Formato de dirección URL de HTTP GET
El siguiente formato se utiliza para solicitudes HTTP GET:
HTTP GET /tables/features.rep;[q=SQL query]&destinationSrs
&[page=pagenumber]&[pageLength=pagelength]
Devolución
Devuelve las funciones especificadas en una tabla con nombre asignado en el repositorio.
{
"type":"FeatureCollection","Metadata":[{"type":"Geometry","name":"Obj",
"style":{},"styleColumn":"MI_Style"},{"type":"String","name":"Country"},
{"type":"String","name":"Capital"},{"type":"String","name":"Continent"},
{"type":"Integer","name":"Numeric_code"},{"type":"String","name":"FIPS"},
{"type":"String","name":"ISO_2"},{"type":"String","name":"ISO_3"},
{"type":"Integer","name":"Pop_1994"},{"type":"Decimal","name":"Pop_Grw_Rt",
"fractionalDigits":1,"totalDigits":6},{"type":"Integer","name":"Pop_Male"},
{"type":"Integer","name":"Pop_Fem"},{"type":"Integer","name":"Pop_0_14"},
{"type":"Integer","name":"Pop_15_64"},{"type":"Integer","name":"Pop_65Plus"},
{"type":"Integer","name":"Male_0_14"},{"type":"Integer","name":"Male_15_64"},
{"type":"Integer","name":"Male_65Plus"},{"type":"Integer","name":"Fem_0_14"},
{"type":"Integer","name":"Fem_15_64"},{"type":"Integer","name":"Fem_65Plus"},
{"type":"Integer","name":"Pop_Urban"},{"type":"Integer","name":"Pop_Rural"},
{"type":"Integer","name":"Pop_Urb_Male"},{"type":"Integer","name":"Pop_Urb_Fem"},
{"type":"Integer","name":"Pop_Rur_Male"},{"type":"Integer","name":"Pop_Rur_Fem"},
{"type":"Decimal","name":"Arable_Pct","fractionalDigits":1,"totalDigits":6},
{"type":"Decimal","name":"Literacy","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Inflat_Rate","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Unempl_Rate","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Indust_Growth","fractionalDigits":1,"totalDigits":4},
{"type":"Integer","name":"ColorCode"},{"type":"Style","name":"MI_Style"}]
}
Ejemplo
Arroja las características de los registros donde el país es CANADÁ para la tabla WorldTable ubicada en el directorio /Samples/NamedTables en el repositorio.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/features.json?q=SELECT * FROM
"/Samples/NamedTables/WorldTable" WHERE Country='CANADA'
Formato de dirección URL de HTTP POST
El siguiente formato se utiliza para las solicitudes HTTP POST para la opción Buscar por SQL con el uso de parámetros vinculados:
HTTP POST: /FeatureService/tables/features.rep?
POST Data: [q=MI SQL query]
POST BODY: Content-Type:application/json {bound parameters}
La opción {parámetros vinculados} es un cuerpo json POST (Content-Type: application/json) para la consulta de búsqueda MI SQL que contiene uno o varios parámetros por incluir. Se admiten valores nulos; sin embargo, aún se requiere un tipo.
Devolución
Devuelve las funciones especificadas en una tabla con nombre asignado en el repositorio.
Ejemplos
Búsqueda de funciones mediante el uso de parámetros vinculados:
SELECT WORLD.Capital FROM "/WORLD" as WORLD WHERE MI_CONTAINS(Obj, @geomParam)
{
"parameters": [{
"name": "geomParam",
"value": {
"type": "Point",
"coordinates": [-72, 42],
"crs": {
"type": "name",
"properties": {
"name": "epsg:4326"
}
}
}
}]
}