Creación Ontologías FIWARE Data Model y Publicación APIs NGSI-9. Guía Sofia2

Transcripción

1 Creación Ontologías FIWARE Data Model y Publicación APIs NGSI-9 Guía Sofia2 Junio de 2017

2 Índice 1 INTRODUCCIÓN Qué vamos a hacer FIWARE Data Model Datos de Acceso REGISTRO SOFIA2 CLOUDLAB Registro y Acceso Entorno de Experimentación Sofia2 CloudLab Herramienta de Consulta de datos ACCESO A APIS NGSI-9 A TRAVÉS DE PORTAL DEL DESARROLLADOR DEL API MANAGER ACCESO A APIS NGSI-9 VÍA CURL Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 2

3 1 INTRODUCCIÓN 1.1 Qué vamos a hacer En el documento se explica cómo consumir APIS modeladas conforme semántica FIWARE Data Model y publicadas en la Plataforma siguiendo el protocolo NGSI-9. Para eso se creará un usuario en el Entorno de Experimentación Sofia2 y se explicará cómo acceder a diferentes opciones del Panel de Control. Para el ejemplo se utilizan las Ontologías: GSMA_OffStreetParking_Destino GSMA_PointOfInterest_Beach GSMA_PointOfInterest_Museum Todas ellas creadas con el modelo semántico FIWARE Data Model. 1.2 FIWARE Data Model Los Data Models GSMA y FIWARE se definen en JSON por lo que su representación como Ontología Sofia2 es inmediata (recomendamos al respecto leer el documento Gobierno de Ontologías o el conjunto de posts al respecto). Se recomienda leer este post: Datos de Acceso Si no se desea crear un nuevo usuario se pueden usar estos credenciales: Usuario: LaboratorioVirtual2 Password: LabVirtual2 API Key (Token Acceso APIs): ee2ba45ec3f342a186d8b92e83e50e99

4 2 REGISTRO SOFIA2 CLOUDLAB 2.1 Registro y Acceso Entorno de Experimentación Sofia2 CloudLab El primer paso será crear un usuario en el Entorno de Experimentación: Si no tenemos usuario crearemos una nueva cuenta: Una vez registrados accederemos al Panel de Control de Sofia2. Primero tendré que suscribirme a las Ontologías de las que queremos obtener los datos, para ello, accedo al menú: Ontologías > Mis Suscripciones Queremos acceder a los datos proporcionados por las Ontologías: GSMA_OffStreetParking_Destino GSMA_PointOfInterest_Beach GSMA_PointOfInterest_Museum Para ello, deberemos seleccionar cada una de ellas en el buscador: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 4

5 Y me suscribiré a cada una clicando en el y pulsaré en Suscribirse: Cuando hayamos hecho este proceso para las 3 Ontologías veremos cómo nos aparecen en Mis Suscripciones : Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 5

6 2.2 Herramienta de Consulta de datos Esta utilidad permite comprobar los datos que mantiene la plataforma. Para eso seleccionaré Herramientas > Consola BDTR y BDH Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 6

7 Seleccionaremos la Ontología GSMA_OffStreetParking_Destino y pulsaremos Realizar Consulta Esto me devuelve estos datos: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 7

8 3 ACCESO A APIS NGSI-9 A TRAVÉS DE PORTAL DEL DESARROLLADOR DEL API MANAGER A continuación, comprobaremos cómo podemos acceder a estos datos a través del Portal del Desarrollador del API Manager: Para ello iremos a API MANAGER > Suscripción a APIs En la Herramienta de búsqueda, escribiremos GSMA y nos suscribiremos a las APIs: gsma_parking_ngsi gsma_poi_beach gsma_poi_museum Éstas APIs, soportan el protocolo de comunicación NGSI 9/10 v2. Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 8

9 Accediendo a API MANAGER > APIs comprobaremos que estamos suscritos a las 3 APIs y, antes de acceder a los datos, pulsaremos sobre Mi API Key, y copiaremos el Token de Usuario: Ahora ya podremos acceder a los datos pulsando en TEST & Doc en cada una de las APIs disponibles en Mis Suscripciones: Por ejemplo, vamos a probar con el API gsma_parking_ngsi. Queremos conocer todos los parkings donde queden más de 50 plazas disponibles. Para ello pulsamos Test & Doc, Introduciremos el Token y, en el campo ngsiquery escribiremos:?type=offstreetparking&q=availablespotnumber>50 Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 9

10 Pulsaremos en Submit y obtendremos: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 10

11 Como Segundo ejemplo vamos a probar con el API gsma_poi_beach. En esta ocasión queremos obtener las playas que tengan el tipo de arena blanca y tengan paseo marítimo. Para ello pulsamos Test & Doc, Introduciremos el Token y, en el campo ngsiquery escribiremos:?type=beach&q=beachtype=whitesand,facilities=promenade Y pulsaremos en Submit: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 11

12 Por último, generaremos un ejemplo para probar el API gsma_poi_museum. En esta ocasión queremos obtener los museos que estén situados en Barcelona y sean tel tipo Bellas Artes. Para ello pulsamos Test & Doc, Introduciremos el Token y, en el campo ngsiquery escribiremos:?type=museum&q=address.addresslocality=barcelona,museumtype=finearts Y pulsaremos en Submit obteniendo los datos: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 12

13 4 ACCESO A APIS NGSI-9 VÍA CURL A continuación, se explica cómo acceder a las APIS publicadas siguiendo NGSI-9 vía curl. curl -v --header "auth-token:<my_token>" Usando el API Key identificado en el punto 1.1 tendría: curl -v --header "auth-token:ee2ba45ec3f342a186d8b92e83e50e99" " Obteniendo como resultado: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 13

14 Para el caso del API GSMA_PointOfInterest_Beach la invocación vía curl se puede realizar: curl -v --header "auth-token:ee2ba45ec3f342a186d8b92e83e50e99" " Obteniendo como resultado: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 14

15 Para el caso de Museos tendré: curl -v --header "auth-token: ee2ba45ec3f342a186d8b92e83e50e99" " Obteniendo los datos: Uso FIWARE Data Model y Publicación APIs NGSI en Sofia2 IoT Platform 15