Salta el contingut

API giscube ID

Documentación API giscube ID

Giscube ID

Todas las capas del Giscube disponen de un identificador único llamado giscube_id. Este identificador está formado por dos números separados por un punto xx.xx:

  • Primer número: indica el tipo de capa según la tabla django_content_type.
  • Segundo número: identificador de la capa dentro de la tabla correspondiente según el tipo de capa.

URL API
Endpoint geoportal/giscube_id/giscube_id
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/geoportal/giscube_id/40.8

El Endpoint retorna la información de la capa indicada en el valor del código giscube_id especificado.

{
    {
      "group": true,
      "title": "Ortoimatge 2009",
      "legend": "",
      "catalog": [
        "9- Base Cartogràfica Aj.",
        "Ortoimatges"
      ],
      "options": {

      },
      "private": false,
      "children": [
        {
          "url": "https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/imageserver/services/xxxx/",
          "type": "WMS",
          "group": false,
          "title": "Ortoimatge 2009",
          "layers": "2009_NW,2009_NE,2009_SW,2009_SE",
          "giscube": {
            "downloadable": false,
            "single_image": false,
            "getfeatureinfo_support": false
          },
          "projection": 4326
        }
      ],
      "keywords": "orto, ortoimatge, vol, raster, 2009",
      "metadata": {
        "bbox": "1.058464,41.101733,1.19133,41.191056",
        "date": "2009-01-01",
        "summary": "Ortoimatge 2009",
        "category": "Capes Ajuntament",
        "language": "ca",
        "information": "Capa generada per l'Ajuntament",
        "provider_web": "https://www.xxxx.cat/",
        "provider_name": "Ajuntament de xxxx",
        "provider_email": "cartografia@xxxx.cat"
      },
      "giscube_id": "40.8",
      "category_id": 54,
      "description": "Ortoimatge 2009",
      "has_children": true
    }
}

Autenticación

Para acceder a esta API se requiere autenticación o no, según los permisos de la capa que estamos consultando. Es decir, se debe enviar un token al servidor.

Esto se puede hacer de dos maneras:

  • Parámetro access_token en una petición GET
Parámetro access_token
Ejemplo https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/geoportal/giscube_id/40.8?access_token=JIFbeOLxkW87wvu3a5at9164IGv7w7
  • Cabecera HTTP
Parámetro Authorization
Ejemplo Authorization=Bearer JIFbeOLxkW87wvu3a5at9164IGv7w7

La API del giscube id es pública, pero hay registros de las tablas vinculadas a las categorías que no lo son. En el caso de no estar autenticados, obtendremos todas las categorías y los valores de las tablas públicas aparecerán en la propiedad content como se ha visto anteriormente. Si una tabla es privada, la categoría aparecerá igualmente, pero no su contenido. Si estamos autenticados, obtendremos todos los resultados.

Consulta la API catálogo para toda la información sobre la autenticación.

Parámetros de la API

La API no dispone de parámetros.