Cómo crear geocercas usando REST

Esta guía muestra cómo crear diferentes tipos de geocercas usando REST API.

Lee más sobre geocercas en GpsGate aquí.

Requisitos

El recurso Geofences REST API requerirá la siguiente información, lee aquí cómo obtenerla:

• Lee cómo habilitar REST API
• Lee cómo generar el token de REST API
• Lee cómo obtener un ID de aplicación

Recurso utilizado

• Geofences > Post

Creando una geocerca circular

1. Inicia sesión en http://host_name/comGpsGate/api/v.1/test 

Nota: reemplaza host_name con la dirección IP de tu servidor o el nombre del host.

2. Navega a Geofences. Haz clic en el nombre del recurso POST/applications/...../geofences > Try it out opción.

3. Se te pedirá que ingreses cualquiera de los 3 modelos de geocercas disponibles para cada tipo de geocerca:

• Geocercas circulares
• Geocercas poligonales
• Geocercas de ruta

Ingresaremos el modelo de Geocerca circular de esta manera:

{
"shapeType": "Circle",
"name": "GpsGate office",
"description": "",
"circleShape": {
"radius": 100,
"center": {
"longitude": 18.03068,
"latitude": 59.33583
}
},
},

4. Haz clic en Execute

Si todo salió bien, verás el estado "200" en la respuesta, con un ID de geocerca generado:

Ten en cuenta que en la aplicación, verás tu geocerca bajo Geocercas no agrupadas

Creando una geocerca poligonal

Para crear un polígono, sigue el mismo número de pasos que para un círculo. Para el modelo de forma, utiliza el siguiente ejemplo como referencia (este polígono contiene cuatro vértices):

{
"shapeType": "Polygon",
"name": "Polytest",
"description": "",
"polygonShape": {
"vertices": [
{
"longitude": 18.049890518188477,
"latitude": 59.348228454589844
},
{
"longitude": 18.050880432128906,
"latitude": 59.34706115722656
},
{
"longitude": 18.054359436035156,
"latitude": 59.34751892089844
},
{
"longitude": 18.053640365600586,
"latitude": 59.348899841308594
},
{
"longitude": 18.049890518188477,
"latitude": 59.348228454589844
}
]
},
}

Este modelo debería crear esta geocerca poligonal en el mapa:

Creando una geocerca de ruta

Para crear una Geocerca de Ruta, sigue el mismo número de pasos que los anteriores. Para el modelo de forma, utiliza el siguiente ejemplo como referencia:

{
"shapeType": "Route",
"name": "Highway",
"description": "",
"routeShape": {
"vertices": [
{
"longitude": 18.046859741210938,
"latitude": 59.347999572753906
},
{
"longitude": 18.04612922668457,
"latitude": 59.34782028198242
},
{
"longitude": 18.047000885009766,
"latitude": 59.34693908691406
},
{
"longitude": 18.04707908630371,
"latitude": 59.346858978271484
},
{
"longitude": 18.04865074157715,
"latitude": 59.34727096557617
},
{
"longitude": 18.049619674682617,
"latitude": 59.34751892089844
},
{
"longitude": 18.05143928527832,
"latitude": 59.347999572753906
},
{
"longitude": 18.051620483398438,
"latitude": 59.34804153442383
},
{
"longitude": 18.052310943603516,
"latitude": 59.347320556640625
},
{
"longitude": 18.053129196166992,
"latitude": 59.346439361572266
},
{
"longitude": 18.053199768066406,
"latitude": 59.34635925292969
},
{
"longitude": 18.053510665893555,
"latitude": 59.346439361572266
}
],
"radius": 3.6469114871954655
},
}

Este modelo debería crear la siguiente geocerca de ruta en el mapa: