GeoAPI Reus

Descripció

GeoAPI Reus és una API REST per la consulta de dades geospacials de l’Ajuntament de Reus.

El servei retorna sempre les dades en format JSON.

Es poden configurar les consultes de l'API amb els següents paràmetres. Els paràmetres es poden combinar.

q : consulta a realitzar. Retorna tots els resultats que continguin el parametre que volem buscar


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=prim

epsg : (opcional) sistema de coordenades amb els que retornar el resultat. S'accepten els sistemes de coordenades 4326 i 25831. Aquest paràmetre és opcional, si no s’especifica es retornaran les dades amb 4326

        
     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=prim&epsg=28531

e : (opcional) per si volem buscar en un element concret. Indicar codi element.

        
     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=prim&e=carrer

p : indicar un punt: x y separats per comes i amb símbol decimal punt. Si no s’indica el paràmetre epsg s'utilitza el sistema de coordenades 4326

        
     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?p=1.1253550106,41.1610478546

r : (opcional) radi de cerca en metres en les consultes per punt, sempre en metres. Per defecte 25 metres.

        
     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?p=1.1253550106,41.1610478546&r=100

L’API permetrà buscar els següents elements:
carrers, adreces, barris, seccions censals, districte, topònims, col·legis electorals, àmbits col·legis electorals, illes i parcel·les cadastrals, bases geodèsiques.
Els elements es poden combinar en una consulta afegint una coma, per exemple: .../?q=prim&e=carrer,adreca

Sortida de dades

La sortida sempre retornarà els resultats obtinguts més un camp addicionals per indicar l’estat de la consulta (OK o KO). Els resultats es retornaran dins el camp resultats. Els resultats s’agruparan per tipus d’elements. Per exemple:


    {
        "resultat": {
            "carrer":[
            {
                "id": ...,
                "nom": "...",
                "codi": ...,
                "geom":{
                    "type": "Point",
                    "coordinates": [
                        1.107182794,
                        41.1559838749
                    ]
                }
            },
            {
                "id": ...,
                "nom": "...",
                "codi": ...,
                "geom":{
                    "type": "...",
                    "coordinates": [...]
                }
            }
            ],
            "adreca": [
            {
                "id": ...,
                "geom":{
                    "type": "...",
                    "coordinates": [...]
                }
                "etiqueta": "...",
                "nom_carrer": ...,
            },
            ...
            ],
            ...
        },
        "estat": "OK"
    }

Elements a buscar

Carrers

Servei per obtenir els carrers de la ciutat de Reus. Per obtenir un JSON amb carrers de Reus posarem e = carrer a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=prim&e=carrer

Obtindrem un JSON amb els camps:

id: identificador carrer a la DB
codi: codi del carrer
nom: nom del carrer
geom: geometria del carrer

Exemple:


    {
        "resultat": {
            "carrer":[
            {
                "id": ...,
                "nom": "...",
                "codi": ...,
                "geom":{
                    "type": "...",
                    "coordinates": [...,...]
                }
            }]
        },
        "estat": "OK"
    }

Adreces

Servei per obtenir les adreces de la ciutat de Reus. Per obtenir un JSON amb adreces de Reus posarem e = adreca a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=prim&e=adreca

Obtindrem un JSON amb els camps:

id: identificador l'adreça a la DB
etiqueta: etiqueta o número adreça
nom_carrer: nom del carrer, plaça, etc, en el que està ubicada l'adreça
geom: geometria de l'adreça (point)

Exemple:


    {
        "resultat": {
            "adreca":[
            {
                "id": ...,
                "geom":{}
                "etiqueta": "...",
                "nom_carrer": ...,
            }]
        },
        "estat": "OK"
    }

Barris

Servei per obtenir els barris de la ciutat de Reus. Per obtenir un JSON amb barris de Reus posarem e = barri a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=muralla&e=barri

Obtindrem un JSON amb els camps:

num: número identificador del barri a la DB
nom: nom del barri
geom: geometria del barri (polígon/multipolígon)

Exemple:


    {
        "resultat": {
            "barri":[
            {
                "num": ...,
                "nom": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Secció censal

Servei per obtenir les seccions censals de la ciutat de Reus. Per obtenir un JSON amb barris de Reus posarem e = sec_censal a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=01&e=sec_censal

Obtindrem un JSON amb els camps:

id: identificador de la secció censal a la DB
num: número de la secció censal
geom: geometria de la secció censal (polígon/multipolígon)

Exemple:


    {
        "resultat": {
            "sec_censal":[
            {
                "id": ...,
                "num": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Districte

Servei per obtenir els districtes de la ciutat de Reus. Per obtenir un JSON amb districtes de Reus posarem e = districte a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=1&e=districte

Obtindrem un JSON amb els camps:

num: número del districte
geom: geometria del districte (polígon/multipolígon)

Exemple:


    {
        "resultat": {
            "districte":[
            {
                "num": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Topònim

Servei per obtenir els topònims de la ciutat de Reus. Per obtenir un JSON amb topònims de Reus posarem e = toponim a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=escola&e=toponim

Obtindrem un JSON amb els camps:

id: identificador topònim a la DB
etiqueta: etiqueta/nom del topònim
angle: angle del topònim
principal: si és principal o no (true/false)
geom: geometria del topònim (point)

Exemple:


    {
        "resultat": {
            "toponim":[
            {
                "id": "...",
                "etiqueta": "...",
                "angle": "...",
                "principal": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Col·legis electorals

Servei per obtenir els col·legis electorals de la ciutat de Reus. Per obtenir un JSON amb col·legis electorals de Reus posarem e = colegi_electoral a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=CEIP%20Pompeu%20Fabra&e=colegi_electoral

Obtindrem un JSON amb els camps:

id: identificador del col·legi electoral a la DB
nom: nom del col·legi electoral
geom: geometria del col·legi electoral (multipolígon)

Exemple:


    {
        "resultat": {
            "colegi_electoral":[
            {
                "id": "...",
                "nom": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Àmbits col·legis electorals

Servei per obtenir els àmbits dels col·legis electorals de la ciutat de Reus. Per obtenir un JSON amb àmbits dels col·legis electorals de Reus posarem e = ambit_colegi a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=CEIP%20Pompeu%20Fabra&e=ambit_colegi

Obtindrem un JSON amb els camps:

id: identificador de l'àmbit del col·legi electoral a la DB
nom: nom de l'àmbit del col·legi electoral
geom: geometria de l'àmbit del col·legi electoral (multipolígon)

Exemple:


    {
        "resultat": {
            "ambit_colegi":[
            {
                "id": "...",
                "nom": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Illa cadastral

Servei per obtenir les illes cadastrals de la ciutat de Reus. Per obtenir un JSON amb illes cadastrals de Reus posarem e = illa_cadastral a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=CF4538C&e=illa_cadastral

Obtindrem un JSON amb els camps:

id: identificador de l'illa a la DB
refpla: referència de l'illa
illanum: codi de l'illa
idmanzana: identificador de l'illa a la DB
geom: geometria de l'illa cadastrals (multipolígon)

Exemple:


    {
        "resultat": {
            "illa_cadastral":[
            {
                "id": "...",
                "geom":{}
                "refpla": "...",
                "illanum": "...",
                "idmanzana": "...",
            }]
        },
        "estat": "OK"
    }

Parcel·la cadastral

Servei per obtenir les parecel·les cadastrals de la ciutat de Reus. Per obtenir un JSON amb parecel·les cadastrals de Reus posarem e = parcella a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?q=CF4538C&e=parcella

Obtindrem un JSON amb els camps:

id: identificador de les parecel·les cadastrals a la DB
num1:
refcad: referència cadastral de la parcel·la
refpar: referència de la parcel·la
refpla:
lletra1:
idmanzana: identificador de l'illa a la DB
geom: geometria de les parecel·les cadastrals (multipolígon)

Exemple:


    {
        "resultat": {
            "parcella":[
            {
                "id": "...",
                "num1": "...",
                "refcad": "...",
                "refpar": "...",
                "refpla": "...",
                "lletra1": "...",
                "idmanzana": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Xarxa de bases geodèsiques

Servei per obtenir les xarxes de bases geodèsiques de la ciutat de Reus. Per obtenir un JSON amb xarxes de bases geodèsiques de Reus posarem e = base a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?p=1.103596,41.15419&r=50&e=base

Obtindrem un JSON amb els camps:

id: identificador de la base geodèsica a la DB
lat: latitud de la base
long: longitud de la base
nom: nom de la base
codi: codi de la base
foto1: foto "camp" de la base
foto2: foto "camp" de la base
tipus: tipus de base geodèsica
altura: altura de la base geodèsica
escala: escala de la base geodèsica
numero: número de la base geodèsica
precodi: precodi de la base geodèsica
x_23031: coordenada x de la base geodèsica en el sistema de referència EPSG: 23031
x_25831: coordenada x de la base geodèsica en el sistema de referència EPSG: 25831
y_23031: coordenada y de la base geodèsica en el sistema de referència EPSG: 23031
y_25831: coordenada y de la base geodèsica en el sistema de referència EPSG: 25831
z_23031: coordenada z de la base geodèsica en el sistema de referència EPSG: 23031
z_25831: coordenada z de la base geodèsica en el sistema de referència EPSG: 25831
ubicacio: ubicació de la base
data_alta: data d'alta de la base
data_baixa: data de baixa de la base
convergencia: convergència de la base
observacions: altres observacions
geom: geometria de la base geodèsica (point)

Exemple:


    {
        "resultat": {
            "base":[
            {
                "id": "...",
                "lat": "...",
                "nom": "...",
                "codi": "...",
                "foto1": "...",
                "foto2": "...",
                "tipus": "...",
                "altura": "...",
                "escala": "...",
                "numero": "...",
                "precodi": "...",
                "x_23031": "...",
                "x_25831": "...",
                "y_23031": "...",
                "y_25831": "...",
                "z_23031": "...",
                "z_25831": "...",
                "ubicacio": "...",
                "data_alta": "...",
                "data_baixa": "...",
                "convergencia": "...",
                "observacions": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }

Punts d'interès

Servei per obtenir els punts d'interès de la ciutat de Reus. Per obtenir un JSON amb punts d'interès de Reus posarem e = poi a la consulta com es fa a la consulta següent:


     url: https://geoportal.reus.cat/apps/giscube-admin/plugins/mapiareus_search/search/?p=1.103596,41.15419&r=50&e=poi

Obtindrem un JSON amb els camps:

id: identificador del punt d'interès a la DB
nid: url del punt d'interès
code: codi del punt d'interès
info: informació del punt d'interès
name: nom del punt d'interès
icona: icona amb el que es representa el punt d'interès
layer: capa on representar el punt d'interès
imatge: imatge del punt d'interès
category: categoria/classificació del punt d'interès
coloricona: color de la icona del punt d'interès
description: descripció del punt d'interès
geom: geometria del punt d'interès (point)

Exemple:


    {
        "resultat": {
            "poi":[
            {
                "id": "...",
                "nid": "...",
                "code": "...",
                "info": "...",
                "name": "...",
                "icona": "...",
                "layer": "...",
                "imatge": "...",
                "category": "...",
                "coloricona": "...",
                "description": "...",
                "geom":{}
            }]
        },
        "estat": "OK"
    }