Salta el contingut

API metadatos

URL de la API

Endpoint api/v2/giscube/search/
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/

Autenticación

Para acceder a esta API se requiere autenticación. Es decir, se debe enviar un token al servidor.

Esto se puede enviar de dos maneras:

  • Parámetro access_token en una solicitud GET
Parámetro access_token
Ejemplo https://xxxxxxx.xxxxxxx.xxx/giscube-admin/api/v2/giscube/search/?access_token=JIFbeOLxkW87wvu3a5at9164IGv7w7
  • Cabecera HTTP
Parámetro Authorization
Ejemplo Authorization=Bearer JIFbeOLxkW87wvu3a5at9164IGv7w7

Generar Token

Ejemplo de llamada para generar un token

CLIENT_ID=b84uwJOlbtjeTAtThoazZFssE4RimQh3kyEiA8Z2

USERNAME=ejemplo

PASSWORD=ejemplo

curl -X POST -d "client_id=$CLIENT_ID&grant_type=password&username=$USERNAME&password=$PASSWORD" \

  https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/o/token/

Parámetros de la API

Búsqueda por texto
Parámetro q
Descripción Búsqueda por coincidencia de texto en los campos ‘name’, ‘title’, ‘keywords’, ‘metadata.provider_name’, ‘category.title’, ‘description’
Ejemplo q=escoles
Búsqueda por fecha
Parámetro d
Descripción Búsqueda por metadata.data. Búsqueda por año o rango de fechas (separadas por coma) Formato: yyyy
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?d=2010,2020
https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?d=2020
Observaciones Búsqueda por un año específico o por un período de años
Búsqueda por tipo de elemento
Parámetro e
Descripción Búsqueda por tipo de elemento: giscube.dataset, imageserver.service, qgisserver.service, layerserver.geojsonlayer, layerserver.databaselayer
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?e=giscube.dataset
Búsqueda por distancia
Descripción Búsqueda de elementos que por intersección estén a una distancia de un punto
Parámetro p
Descripción del parámetro Par de decimales, coordenada, que corresponde a la longitud y la latitud, separada por una coma. Los decimales deben estar en formato inglés
Parámetro r
Descripción del parámetro Radio en metros. Por defecto 25 metros. Opcional.
Parámetro epsg
Descripción del parámetro Indica el sistema de coordenadas de la geometría. Ejemplo: epsg=25831. Opcional. Por defecto 4326.
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?p=1.111068,41.144431
Intersección con una geometría
Descripción Búsqueda de elementos que intersectan con la geometría del cuadro delimitador (bbox)
Parámetro intersects
Descripción del parámetro Geometría en formato wkt
Parámetro epsg
Descripción del parámetro Indica el sistema de coordenadas de la geometría. Ejemplo: epsg=25831. Opcional. Por defecto 4326
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?intersects=LINESTRING(1.0968840476263697%2041.15210198069979,1.1035788413275416%2041.14919367735578,1.1106169577826197%2041.15126181742966)
Dentro de los límites de una geometría
Descripción Búsqueda de elementos que están completamente dentro de una geometría especificada.
Parámetro contains
Descripción del parámetro Geometría en formato wkt
Parámetro epsg
Descripción del parámetro Indica el sistema de coordenadas de la geometría. Ejemplo: epsg=25831. Opcional. Por defecto 4326
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/api/v2/giscube/search/?contains=POLYGON((-1.6796875000000178%2045.320172290013765,6.582031249999982%2045.320172290013765,6.582031249999982%2037.8389415037292,-1.6796875000000178%2037.8389415037292,-1.6796875000000178%2045.320172290013765))