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.
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
Si todo salió bien, verá el estado "200" en la respuesta, con un ID de geocerca generado:
Tenga en cuenta que en la aplicación, verá su geocerca bajo Geocercas no agrupadas
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:
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: