# Crimedata LatLon
Este servicio retorna las variables con información de nivel de delito de la ubicación latitud, longitud solicitada. Dicha ubicación puede provenir de un dispositivo tipo GPS de un celular, Laptop, Pc, etc. O de información almacenada en sus repositorios de datos.
Parámetros obligatorios en una solicitud de Crimedata:
- latlon: los valores de latitud y longitud que especifican la ubicación para la que desea obtener la información de Crimedata.
- 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 Crimedata LatLon
La siguiente petición base del servicio tendría la siguiente estructura:
https://apis.geodir.co/crimedata/v1/json?latlon=-12.059888,-77.049072&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",
"groups": [
{
"name": "grid_code",
"description": "Codigo de Identificación Única",
"fields": [
{
"name": "grid_code",
"value": 657668,
"typeField": "integer",
"description": "Codigo de Identificación Única"
}
]
},
{
"name": "peso",
"description": "Peso",
"fields": [
{
"name": "weight",
"value": 0,
"typeField": "integer",
"description": "Peso del Nivel de Delito"
}
]
},
{
"name": "riesgo",
"description": "Riesgo",
"fields": [
{
"name": "risk",
"value": "Bajo",
"typeField": "text",
"description": "Nivel de Delito"
}
]
},
{
"name": "asalto",
"description": "Asalto Robo de Vehículos",
"fields": [
{
"name": "vechicle_theft_assasult",
"value": 0,
"typeField": "integer",
"description": "Asalto Robo de Vehículos"
}
]
},
{
"name": "estafa",
"description": "Estafa",
"fields": [
{
"name": "fraud",
"value": 0,
"typeField": "integer",
"description": "Estafa"
}
]
},
{
"name": "extorsión",
"description": "Extorsión",
"fields": [
{
"name": "extortion",
"value": 0,
"typeField": "integer",
"description": "Extorsión"
}
]
},
{
"name": "homicidio",
"description": "Homicidio",
"fields": [
{
"name": "qualified_homicide",
"value": 0,
"typeField": "integer",
"description": "Homicidio Calificado"
},
{
"name": "firearms_homicide",
"value": 0,
"typeField": "integer",
"description": "Homicidio por Armas de Fuego"
}
]
},
{
"name": "hurto",
"description": "Hurto",
"fields": [
{
"name": "robbery",
"value": 0,
"typeField": "integer",
"description": "Hurto"
},
{
"name": "aggravated_robbery",
"value": 0,
"typeField": "integer",
"description": "Hurto Agravado"
},
{
"name": "aggravated_robbery_inhabited_house",
"value": 0,
"typeField": "integer",
"description": "Hurto Agravado Casa Habitada"
},
{
"name": "vehicle_robbery",
"value": 0,
"typeField": "integer",
"description": "Hurto Vehículo"
},
{
"name": "attempted_robbery",
"value": 0,
"typeField": "integer",
"description": "Hurto Frustrado"
}
]
},
{
"name": "microcomercialización de droga",
"description": "Microcomercialización de Droga",
"fields": [
{
"name": "drug_microcommercialization",
"value": 0,
"typeField": "integer",
"description": "Microcomercialización de Droga"
}
]
},
{
"name": "robo",
"description": "Robo",
"fields": [
{
"name": "theft",
"value": 0,
"typeField": "integer",
"description": "Robo"
},
{
"name": "aggravated_theft",
"value": 0,
"typeField": "integer",
"description": "Robo Agravado"
},
{
"name": "aggravated_armed_theft",
"value": 0,
"typeField": "integer",
"description": "Robo Agravado Mano Armada"
},
{
"name": "aggravated_theft_night",
"value": 0,
"typeField": "integer",
"description": "Robo Agravado por la Noche"
},
{
"name": "attempted_theft",
"value": 0,
"typeField": "integer",
"description": "Robo Frustrado"
}
]
},
{
"name": "secuestro",
"description": "Secuestro",
"fields": [
{
"name": "kidnapping",
"value": 0,
"typeField": "integer",
"description": "Secuestro"
}
]
},
{
"name": "tenencia informal de armas",
"description": "Tenencia Informal de Armas",
"fields": [
{
"name": "informal_possession_weapons",
"value": 0,
"typeField": "integer",
"description": "Tenencia Informal de Armas"
}
]
},
{
"name": "violencia sexual de menores",
"description": "Violencia Sexual de Menores",
"fields": [
{
"name": "child_sexual_violence",
"value": 0,
"typeField": "integer",
"description": "Violencia Sexual de Menores"
}
]
},
{
"name": "establecimientos penitenciarios",
"description": "Establecimientos Penitenciarios",
"fields": [
{
"name": "penitentiary_establishments",
"value": 0,
"typeField": "integer",
"description": "Establecimientos Penitenciarios"
}
]
},
{
"name": "lugar de residencia",
"description": "Lugar de Residencia",
"fields": [
{
"name": "place_residence",
"value": 0,
"typeField": "integer",
"description": "Lugar de Residencia"
}
]
},
{
"name": "geom",
"description": "Geometria",
"fields": [
{
"name": "geom",
"value": null,
"typeField": "geometry",
"description": "Geometria"
}
]
},
{
"name": "Localización",
"description": "Localización",
"fields": [
{
"name": "admin_level_3_code",
"value": "150105",
"typeField": "text",
"description": "Código de ubigeo"
}
]
}
]
}
# Respuestas de Crimedata LatLon
A continuación se muestran los códigos de estado posibles en una respuesta de Crimedata.
# Códigos de Estado de Crimedata LatLon
El campo "status" dentro del objeto de respuesta de crimedata 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 crimedata no produjo errores; el servicio realizo la acción correctamente.
- "ZERO_RESULTS" indica que el servicio crimedata 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.
# Parámetros opcionales
Parámetros opcionales:
- Groups: Es un filtro con elementos separados por una tubería (|). El filtro de grupos también se acepta como parámetro opcional. Cada elemento consta de un par grupo lo cual es un valor y restringe completamente los resultados de crimedata. Consulte más información sobre el filtrado de grupos.
- info: es una serie de valores útiles al cliente para almacenar información complementaria o metadatos, estos elementos deben estar separados por una tubería (|).
# Filtrado de grupos
En una respuesta de Crimedata, la API de Crimedata puede devolver resultados restringidos a un área específica. Puede especificar la restricción utilizando el filtro de grupos. Un filtro consta de una lista de pares sgroup:value separados por una barra vertical (|). Los valores de filtro admiten los mismos métodos de corrección ortográfica y coincidencia parcial que otras solicitudes de Crimedata.
Los siguientes groups pueden usarse para influir en los resultados, pero no se aplicarán:
- locality coincide con tipos locality y sublocality.
Notas sobre el filtrado de grupos:
- Los resultados son consistentes con Geodir Maps, que ocasionalmente produce respuestas ZERO_RESULTS.
- Para cada segmento de dirección, especifíquelo en el parámetro de group.
https://apis.geodir.co/crimedata/v1/json?latlon=-12.059888,-77.049072&group=locality_id:150105&info=cod_peticion:1020|canal:abc|origen_sistema:cde