# Prisões

> Os dados do sistema penitenciário avalia a proximidade de determinada coordenada geográfica à um presídio do sistema penitenciário brasileiro. Além da indicação de proximidade do sinal de localização à um presídio, também são fornecidas informações que indicam o porte do presídio e a quantidade de estelionatários cumprindo pena no local.

**Base**: `https://api.prismadata.io/v1`

**Autenticação**: header `X-Apikey` (ou query `api_key`). Detalhes em [Autenticação](autenticacao.md).

**Formato de resposta**: JSON plano com campos `prismadata__<serviço>__<campo>`; em lote, dicionário indexado pelas chaves enviadas. Detalhes em [Formato de Resposta](guias/formato-de-resposta.md).

## Endpoints

### `POST /location/batch/prison`

Consulta em lote a proximidade a estabelecimentos prisionais do sistema penitenciário brasileiro. Cada ponto é identificado por um id próprio e recebe a mesma resposta do endpoint unitário. A cobrança é feita por coordenada do lote.

**Exemplo curl**:

```bash
curl -X POST "https://api.prismadata.io/v1/location/batch/prison" \
  -H "X-Apikey: SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "point1": [
           -23.5505,
           -46.6333
         ],
         "point2": [
           40.7128,
           -74.006
         ]
       }'
```

**Request body** (`application/json`):

Dicionário `{string: array[number]}`.
Modelo da entrada em batch

**Response 200** (`application/json`):

> Successful Response

Dicionário `{string: object}`.
Dicionário onde as chaves são identificadores únicos para cada ponto consultado

**Outros códigos**: 401, 403, 422, 429

---

### `GET /location/prison`

Consulta a proximidade de um ponto a estabelecimentos prisionais do sistema penitenciário brasileiro, num raio de até 5 km. Informa se o ponto está dentro de um presídio e as distâncias, em metros, até o centroide e até a borda do estabelecimento mais próximo.

**Exemplo curl**:

```bash
curl -X GET "https://api.prismadata.io/v1/location/prison?lat=-25.52568655357868&lng=-54.59273323017718" \
  -H "X-Apikey: SEU_TOKEN"
```

**Parâmetros**:

| Nome | Local | Tipo | Obrigatório | Descrição |
|------|-------|------|-------------|-----------|
| `lat` | query | number | sim | Latitude do ponto de consulta. |
| `lng` | query | number | sim | Longitude do ponto de consulta. |

**Response 200** (`application/json`):

> Successful Response

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|-------------|-----------|
| `prismadata__prison__ambito` | string \| null | não | Âmbito do estabelecimento prisional (ESTADUAL, FEDERAL). |
| `prismadata__prison__area_m2` | number \| null | não | Área do estabelecimento prisional em metros quadrados. |
| `prismadata__prison__distancia_borda_m` | number \| null | não | Distância em metros do ponto consultado até a borda do presídio mais próximo. |
| `prismadata__prison__distancia_centroide_m` | number \| null | não | Distância em metros do ponto consultado até o centroide do presídio mais próximo. |
| `prismadata__prison__indice_lotacao_feminino` | number \| null | não | Índice de lotação da população carcerária feminina. |
| `prismadata__prison__indice_lotacao_masculino` | number \| null | não | Índice de lotação da população carcerária masculina. |
| `prismadata__prison__indice_lotacao_total` | number \| null | não | Índice de lotação total do estabelecimento prisional. |
| `prismadata__prison__municipio` | string \| null | não | Nome do município onde o presídio está localizado. |
| `prismadata__prison__nome_estabelecimento` | string \| null | não | Nome do estabelecimento prisional. |
| `prismadata__prison__frac_estelionato_feminino` | number \| null | não | Fração de presas cumprindo pena por estelionato. Valor em [0,1]. |
| `prismadata__prison__frac_estelionato_masculino` | number \| null | não | Fração de presos cumprindo pena por estelionato. Valor em [0,1]. |
| `prismadata__prison__frac_estelionato_total` | number \| null | não | Fração total de detentos cumprindo pena por estelionato. Valor em [0,1]. |
| `prismadata__prison__perimetro_m` | number \| null | não | Perímetro do estabelecimento prisional em metros. |
| `prismadata__prison__ponto_dentro_presidio` | boolean \| null | não | Indica se o ponto consultado está dentro do perímetro do presídio. |
| `prismadata__prison__pop_feminino_total` | number \| null | não | População carcerária feminina total. |
| `prismadata__prison__pop_masculino_total` | number \| null | não | População carcerária masculina total. |
| `prismadata__prison__tipo_estabelecimento` | string \| null | não | Tipo do estabelecimento prisional (PRESOS_PROVISORIOS, REGIME_FECHADO, etc.). |
| `prismadata__prison__total_terceirizacoes` | integer \| null | não | Quantidade de serviços terceirizados no estabelecimento. |
| `prismadata__prison__uf` | string \| null | não | Unidade Federativa onde o presídio está localizado. |

**Outros códigos**: 401, 403, 422, 429

---

## Recursos relacionados

- Documentação Redoc interativa: https://prismadata.io/redoc.html#tag/Prisoes
- OpenAPI só deste produto (JSON): https://prismadata.io/llm/openapi/prisoes.json
- OpenAPI completo: https://prismadata.io/openapi.yaml
- Índice geral: https://prismadata.io/llms.txt