Servicios web
Documentación sobre la funcionalidad Geofencing disponible a través del webservice HTTP-JSON/XML de la plataforma CERCALIA.
La URL base a utilizar es:
- JSON: http://ws.cercalia.com/services/json?markattributes=true&key=<clave API*>
- XML: http://ws.cercalia.com/services/xmlgeo?key=<clave API*>
* Clave de seguridad. Es la misma KEY que para la API de mapas de Cercalia
Las peticiones HTTP se pueden enviar en GET o POST
Las respuestas son en formato JSON / XML
Geofencing masivo: obtener los puntos que se encuentran dentro de una lista de polígonos / circunferencias
PETICIÓN
Ejemplo de petición:
&cmd=insidegeoms&geoms=[CIRCLE(2.2090%2041.4141,%2012)|ID1],%20[CIRCLE(2.3090%2041.4141,%205)|ID2]&molist=[2.2090,41.4141|P1],%20[2.3090,41.4141|P2]
GEOMS |
Lista de geometrías separadas por comas. Cada geometría tiene el siguiente formato: [wkt|id] Donde:
|
SRS |
Sistema de coordenadas de las geometrías. Por defecto geográficas (EPSG:4326) Ej.: EPSG:4326 |
MOLIST |
Lista de puntos en formato MO [X,Y|ID] |
MOCS |
Sistema de coordenadas de los puntos (MOLIST) Por defecto geográficas (EPSG:4326) Ej.: EPSG:4326 |
RESPUESTA
Para cada geometría especificada con el parámetro geoms se devuelven los puntos especificados en el parámetro molist
que están dentro
Ejemplo de respuesta:
<cercalia cmd="insidegeoms" version="1">
<insidegeoms>
<geometry id="ID1">
<wkt>CIRCLE(2.2090 41.4141, 12)</wkt>
<molist num="1">
<mo id="P1">
<coord x="2.209" y="41.4141"/>
</mo>
</molist>
</geometry>
<geometry id="ID2">
<wkt>CIRCLE(2.3090 41.4141, 5)</wkt>
<molist num="1">
<mo id="P2">
<coord x="2.309" y="41.4141"/>
</mo>
</molist>
</geometry>
</insidegeoms>
<server>http://cercalia-tomcat-lbs-instance1:8080</server>
</cercalia>