API panoramas

Documentación API panoramas. Esta API se utiliza en el visor de panoramas y nubes de puntos del geoportal.

Tablas

Los panoramas se definen en dos tablas. La tabla mapia_panoramas_panorama contiene toda la información de los panoramas:

Campo	Definición
id	ID autogenerado
filename	Nombre de la imagen
filetype	Tipo (extensión) de la imagen
sourceid	ID definido por el usuario, puede utilizarse para ordenar los panoramas
capture	Fecha y hora de captura de la panorámica
altitude	Altura sobre el nivel del mar del panorama
roll	Ángulo respecto al eje longitudinal
pitch	Ángulo respecto al eje transversal
pan	Ángulo respecto al eje vertical (orientación con el norte)
geom	Geometría, coordenadas del punto
project_id	Proyecto definido en la tabla mapia_panoramas_project donde se definen, por ejemplo, diferentes campañas de MoMa
category	String para definir una categoría, por ejemplo, diferentes plantas de un edificio

En la tabla mapia_panoramas_project se definen diferentes proyectos de Mobile Mapping. Normalmente va asociado a las campañas, por ejemplo, Panoramas 2018, Panoramas 2020, etc.

Campo	Definición
id	ID autogenerado
code	Código del proyecto, por ejemplo, pano-2020
name	Nombre del proyecto, por ejemplo, Panoramas 2020

URL API

La parte de panoramas es tratada como un módulo externo, no forma parte del giscube admin, por tanto, se agregará como un plugin.

El Endpoint depende del proyecto en el que queramos hacer la búsqueda.

Endpoint	plugins/mapia_panoramas/api/projects/{nombre del proyecto}/panoramas/
Ejemplo	https://rondes3d.infraplan.cat/apps/giscube-admin/plugins/mapia_panoramas/api/projects/pano/panoramas/

Autenticación

Se trata de una API pública, no se requiere autenticación.

Parámetros

Los parámetros de búsqueda de esta API son los siguientes:

Parámetro	Definición	Obligatorio	Ejemplo
p	Coordenadas (lat, lng) del punto que buscamos	*	p=41.3997,2.1133
r	Radio de búsqueda en metros	*	r=15
c	Buscar aquellos que tienen la misma categoría		c=planta_1

La API retorna todos los panoramas que se encuentran dentro del radio de búsqueda (r) ordenados por distancia respecto al punto (p).

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

De esta búsqueda obtendremos el siguiente resultado:

[
    {
        "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
            ]
        }
    },
    {...},
    {...}
]