API panorames

Documentació API panorames. Aquesta API s’utilitza al visor de panorames i núvols de punts del geoportal.

Taules

Els panorames es defineixen en dues taules. La taula mapia_panoramas_panorama conté tota la informació dels panorames:

Camp	Definició
id	id autogenerat
filename	Nom de la imatge
filetype	Tipus (extensió) de la imatge
sourceid	Id definit per l’usuari, pot servir per ordenar els panorames
capture	Data i hora de captura de la panoràmica
altitude	Altura sobre el nivell del mar del panorama
roll	Angle respecte l’eix longitudinal
pitch	Angle respecte l’eix transversal
pan	Angle respecte l’eix vertical (orientació amb el nord)
geom	Geometria, coordenades del punt
project_id	Projecte definit a la taula mapia_panoramas_project on es defineixen p.e. diferents campanyes de MoMa
category	String per definir una categoria p.e. diferents plantes d’un edifici

A la taula mapia_panoramas_project s’hi defineixen diferents projectes de Mobile Mapping. Normalment va associat a les campanyes, p.e. Panorames 2018, Panorames 2020, etc.

Camp	Definició
id	id autogenerat
code	Codi del projecte, p.e. pano-2020
name	Nom del projecte, p.e. Panorames 2020

URL API

La part de panorames es tracta d’un mòdul extern, no forma part del giscube admin, per tant s’afegirà com un plug-in.

L’Endpoint depèn del projecte en el que volguem fer la creca.

Endpoint	plugins/mapia_panoramas/api/projects/{nom del projecte}/panoramas/
Exemple	https://rondes3d.infraplan.cat/apps/giscube-admin/plugins/mapia_panoramas/api/projects/pano/panoramas/

Autenticació

Es tracta d’una API pública, no cal autenticació

Paràmetres

Els paràmetres de cerca d’aquesta API són els següents

Paràmetre	Definició	Obligatori	Exemple
p	Coordenades (lat, lng) del punt que busquem	*	p=41.3997,2.1133
r	Radi de cerca en metres	*	r=15
c	Cerca els que tenen la mateixa categoria		c=planta_1

L’API retorna tots els panorames que es troben dins del radi de cerca (r) ordenats per distància respecte el punt(p)

Exemple	https://rondes3d.infraplan.cat/apps/giscube-admin/plugins/mapia_panoramas/api/projects/pano/panoramas/?p=41.3997,2.1133&r=15

D’aquesta cerca n’obtindrem el següent resultat:

[
    {
        "id":8027,
        "project":"pano",
        "category":null,
        "filename":"181020_Track_H-Sphere-613.jpg",
        "filetype":"JPG",
        "sourceid":28325,
        "capture":"2019-05-02T08:00:00Z",
        "altitude":148.405115384189,
        "roll":0.0,
        "pitch":0.0,
        "pan":-173.766304016036,
        "geom": {
            "type":"Point",
            "coordinates": [
                2.113266164076979,
                41.3997155877604
            ]
        }
    },
    {...},
    {...}
]