Listar imóveis CAR por arquivo (KML ou Shapefile)

POST

/v2/queries/clients/{clientId}/{queryId}/cars/file

Lê um arquivo KML ou Shapefile (.shp) e devolve os imóveis CAR encontrados na área, descartando os que já estão cadastrados e ativos na consulta. O resultado vem ordenado pelo percentual de interseção com a área do arquivo, do maior para o menor. A rota apenas consulta — não cadastra os imóveis. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodymultipart/form-dataNecessário

Respostas

🟢200

application/json

Inferred 200

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/queries/clients/CLIENT_ID/QUERY_ID/cars/file' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

200 - Sucesso

[
    {
        "car": "string",
        "name": "string",
        "totalArea": 0,
        "intersectionPercent": 87.4,
        "areaInformed": {
            "area": 0,
            "tipo": "AREA_IMOVEL",
            "geoJson": {
                "type": "MultiPolygon",
                "coordinates": []
            }
        }
    }
]

Modificado em 2026-10-13 09:47:06

Página anterior

Exportar geometria de um imóvel CAR (KML)

Próxima página

Listar imóveis CAR por coordenadas