# Geofencing LatLon

Este servicio retorna las variables con información definida por las zonas creadas por el usuario, estos pueden ser: zonas peligrosas, zonas de reparto, zonas de cobertura, etc. de la ubicación latitud, longitud solicitada. Dicha ubicación puede provenir de un dispositivo tipo GPS de un celular, Laptop, Pc, Domicilio, etc. O de información almacenada en sus repositorios de datos.

Parámetros obligatorios en una solicitud de Geofencing:

latlon: los valores de latitud y longitud que especifican la ubicación para la que desea obtener la información de Geofencing.
key: la clave API de su aplicación. Esta clave identifica su aplicación a los efectos de la gestión de cuotas. Aprenda a obtener la clave API.

# Ejemplo de Geofencing LatLon

La siguiente petición base del servicio tendría la siguiente estructura:

https://apis.geodir.co/geofencing/v1/json?latlon=-12.060421,-77.010781&key=YOUR_KEY

Nota: Asegúrese de que no exista ningún espacio entre los valores de latitud y longitud cuando se pasa en el parámetro latlon.

{
    "status": "OK",
    "results": [
        {
            "alias": "Capa Zonas peligrosas",
            "namecode": "CAPA_1",
            "spatial_analysis": {
                "name": "intersect",
                "result": false
            },
            "fields": [
                {
                    "name": "type",
                    "value": "peligrosa"
                },
                {
                    "name": "message",
                    "value": "DELINCUENCIAL"
                }
            ]
        },
        {
            "alias": "Capa Itinerante",
            "namecode": "CAPA_2",
            "spatial_analysis": {
                "name": "intersect",
                "result": false
            },
            "fields": [
                {
                    "name": "type",
                    "value": "itinerante"
                },
                {
                    "name": "message",
                    "value": "PRUEBA"
                }
            ]
        }
    ]
}

# Respuestas de Geofencing LatLon

A continuación se muestran los códigos de estado posibles en una respuesta de Geofencing.

# Códigos de Estado de Geofencing LatLon

El campo "status" dentro del objeto de respuesta de Geofencing contiene el estado de la solicitud y puede contener información de depuración para ayudarlo a averiguar por qué la codificación geográfica no funciona. El campo "status" puede contener los siguientes valores:

"OK" indica que el servicio Geofencing no produjo errores; el servicio realizo la acción correctamente.
"ZERO_RESULTS" indica que el servicio Geofencing se realizó correctamente pero no arrojó resultados. Esto puede ocurrir si al servicio se le pasó un latlon inexistente o fuera de zona.
"OVER_QUERY_LIMIT" indica que ha superado su cuota.
"REQUEST_DENIED" indica que su solicitud fue denegada.
"INVALID_REQUEST" generalmente indica uno de los siguientes:
- Falta la consulta (address, groups o latlon).
- Se proporcionó un groups no válido.
"UNKNOWN_ERROR" indica que la solicitud no se pudo procesar debido a un error del servidor. La solicitud puede tener éxito si vuelve a intentarlo.

El campo "alias", describe el nombre del dataset (conjunto de información). Por ejemplo: Zonas Delictivas, Zonas de Reparto, entre otros.

El campo "namecode", hace referencia a una codificación única del dataset (conjunto de información).

El campo "spatial_analysis", hace referencia al tipo de análisis espacial que realiza el servicio de geofencing. Por ejmplo: intersect (Se refiere a una intersección espacial).

← Geofencing Obtiene tu Clave API →