Baixar KML de um imóvel rural

GET

/assets/properties/rural/kml/{propertyId}

Gera e devolve, como arquivo para download, o KML do imóvel rural informado em propertyId, com um polígono para cada parcela do imóvel e o nome e a área de cada parcela. O arquivo vem com o tipo application/vnd.google-earth.kml+xml e o nome .kml. Imóvel sem parcelas devolve 400; imóvel inexistente ou removido devolve 404. O imóvel precisa ser de um cliente da empresa do usuário: cliente de outra empresa devolve 401 (Acesso negado). 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

Respostas

🟢200

application/vnd.google-earth.kml+xml

Arquivo KML

Bodyapplication/vnd.google-earth.kml+xml

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Imóvel sem parcelas

🟠404Imóvel rural não encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/assets/properties/rural/kml/f1a2b3c4-0000-4000-8000-000000000101' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

<?xml version="1.0" encoding="UTF-8"?><kml xmlns="http://www.opengis.net/kml/2.2">...</kml>

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

Página anterior

Remover imóvel rural de um cliente

Próxima página

Cadastrar imóvel urbano de um cliente