BikeSquare Platform API
The BikeSquare Platform displays APIs that allow programmers to develop sites and applications by exploiting their potential
T
he BikeSquare Platform displays the following APIs in json format:
- GetPercorso(x)
- GetPoi(x)
- GetPagina(x)
- GetMenu(x)
- ListPercorsi
- ListPoi
The parameter x refers to the unique identifier of each resource, which can be found beforehand or through the ListPercorsi and ListPoi functions. A specific menu is defined on the platform that contains the tree of the contents that will have to be exposed through API. This content may be of any type of content present on the site. The proposal to use a menu to identify the contents to be presented to the API responds to multiple needs:
- simplifies the use of the Backoffice for administrators (who don't have to learn to use a new tool, but simply use the normal menu they are used to)
- natively manage permissions. The menu does not automatically show contents that are not public or those for which the requesting user does not have access permissions
- manage trees. Unlike a flag system that allows to present only a list of items to display on the APP, the menu allows to create a hierarchy of content to be transferred.
The APP (or any other site with which the system will be interfaced) will in any case be able to query the web server to get the list of all the points of interest and all the routes, so that they can be viewed in the most appropriate way.
OpenData
The BikeSquare Platform can display in such a way as to guarantee openness to other systems, in an OpenData perspective, in particular:
-
All paths are accessible and downloadable in open formats (KML and GPX)
-
All paths are embeddable on other sites transparently, via an iframe embed.
-
For example, the [TerreDeiSavoia]http://www.visitterredeisavoia.it/it/cyclo-monviso/) site used the cicloturismo.piemonte.it routes on its pages dedicated to the CycloMonviso itinerary.