# Crimedata con dirección
Este servicio retorna las variables con información de nivel de delito desde una dirección (domicilio) solicitada. Dicha ubicación puede provenir de direcciones en línea o de información almacenada en sus repositorios de datos.
Parámetros obligatorios en una solicitud de Crimedata:
- address: Especifique las direcciones de acuerdo con el formato utilizado por el servicio postal nacional del país en cuestión. Deben evitarse elementos de dirección adicionales, como nombres comerciales y números de unidad, suite o piso. Los elementos de la dirección postal deben estar delimitados por espacios (que se muestran aquí como URL de escape a% 20).
- 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 con dirección
La siguiente petición base del servicio tendría la siguiente estructura:
https://apis.geodir.co/crimedata/v1/json?address=jr pedro ruiz gallo nro 668&key=YOUR_KEY
Nota: Asegúrese de ingresar una dirección válida para el parámetro address.
{
"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 con dirección
A continuación se muestran los códigos de estado posibles en una respuesta de Crimedata.
# Códigos de Estado de Crimedata con dirección
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: ees un filtro con elementos separados por una tubería (|). El filtro de grupos también se acepta como parámetro opcional si se proporciona una dirección. Cada elemento consta de un par segmento lo cual es un valor y restringe completamente los resultados del 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.
Un código geográfico para "jr pedro ruiz gallo nro 668" con groups=locality_id:150105
https://apis.geodir.co/crimedata/v1/json?address=jr pedro ruiz gallo nro 668&groups=locality_id:150105&info=cod_peticion:1020|canal:abc|origen_sistema:cde