Salta el contingut

API giscube ID

Documentació API giscube ID

Giscube ID

Totes les capes del Giscube disposen d’un identificador únic anomenat giscube_id. Aquest identificador està format per dos números separats per un punt xx.xx:

  • Primer número: indica el tipus de capa segona la taula django_content_type
  • Segon número: identificador de la capa dins la taula corresponent segons el tipus de capa

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

L’Endpoint retorna una la informació de la capa indicada en el valor del codi giscube_id indicat.

{
    {
      "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ó

Per accedir a aquesta API cal autentificació o no segons els permisos de la capa que estem consultant. O sigui, s’ha d’enviar un token al servidor.

Aquest es pot enviar de dues maneres:

  • Paràmetre access_token en una petició GET
Paràmetre access_token
Exemple https://xxxxxxx.xxxxxxx.xxx/apps/giscube-admin/geoportal/giscube_id/40.8?access_token=JIFbeOLxkW87wvu3a5at9164IGv7w7
  • Capçalera HTTP
Paràmetre Authorization
Exemple Authorization=Bearer JIFbeOLxkW87wvu3a5at9164IGv7w7

L’API del giscube id és pública però hi ha registres de les taules vinculades a les categories que no ho són. En el cas de no estar autenticats obtindrem totes les categories i els valors de les taules públiques apareixen a la propietat content com s’ha vist abans. Si una taula és privada la categoria apareixerà igualment però no el seu contingut. Si estem autenticats obtindrem tots els resultats.

Consula la API catàleg per tota la informació sobre l’autenticació.

Paràmetres de l’API

L’API no disposa de paràmetres.