Cómo crear geocercas usando REST

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

Lea más sobre geocercas en GpsGate aquí.

Requisitos

El recurso Geofences REST API requerirá la siguiente información para ser ingresada, lea aquí cómo obtenerla:

Recurso utilizado

  • Geofences > Post

Creando una geocerca circular

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

Nota: reemplace host_name con la dirección IP de su servidor o nombre de host real.

2. Navegue a Geofences. Haga clic en el nombre del recurso POST/applications/...../geofences > Probarlo opción.

mceclip0.png

3. Se le pedirá que ingrese 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. Haga clic en Ejecutar

Screenshot 2024-07-23 at 09.54.06.png

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

Screenshot 2024-07-23 at 09.55.05.png

Tenga en cuenta que en la aplicación, verá su geocerca bajo Geocercas no agrupadas

Screenshot 2024-07-23 at 09.56.16.png

Creando una geocerca poligonal

Para crear un polígono, siga el mismo número de pasos que para un círculo. Para el modelo de forma, use en su lugar 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:

Screenshot 2024-07-23 at 09.35.42.png

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 en su lugar 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:

Screenshot 2024-07-23 at 09.35.50.png