A análise do PDM, dentro do vosso software.

Um pedido HTTP devolve, para qualquer parcela em Portugal continental: a categoria de solo da carta oficial (CRUS/DGT), os parâmetros do regulamento do PDM em vigor (índice, pisos, altura, área mínima, citações dos artigos), as condicionantes RAN/REN e, opcionalmente, o declive do terreno. Para portais imobiliários, gabinetes, promotores e avaliadores.

Endpoint

GET https://pdm.xyzbim.eu/api/v1/analisa

parâmetro	obrigatório	descrição
chave	sim	a sua chave de API (ver «Acesso» abaixo). Em alternativa ao URL, pode enviá-la no cabeçalho `X-Api-Key` — preferível, para a chave não ficar em logs
anel	sim	polígono da parcela em WGS84: `lon,lat;lon,lat;…` (≥ 3 vértices; fecho automático)
dico	não	código do concelho (4 dígitos). Omitido → detetado a partir do polígono
declive	não	`1` acrescenta cota e declive médio/máximo (modelo de terreno EU-DEM 25 m). Se a fonte de terreno falhar, `declive` vem `null`

Exemplo

curl "https://pdm.xyzbim.eu/api/v1/analisa?chave=A_SUA_CHAVE&declive=1&anel=-8.5150,40.1930;-8.5100,40.1930;-8.5100,40.1960;-8.5150,40.1960"

Resposta (campos principais):

{
  "area": 14783.4,                      // m² da parcela
  "partes": [{                          // uma por categoria de solo intersectada
    "designacao": "SOLO RÚSTICO - ESPAÇOS AGRÍCOLAS …",
    "classe": "Solo Rústico",
    "pct": 100, "area": 14783.4,
    "regra": {                          // null quando o concelho ainda não tem regras extraídas
      "ind": 0.4, "ac": 5913,           // índice e área máx. de construção (m²)
      "pisos": 2, "alt": 9,             // pisos e altura máx. (m)
      "amin": null, "edificavel": "condicionado",
      "artigos": ["Artigo 25.º", …], "citacao": "…", "usos": "…"
    },
    "geom": { … }                       // GeoJSON da interseção
  }],
  "condicionantes": { "ran": 8120.5, "ren": null, "temRan": true, "temRen": true },
  "gerais": [ … ],                      // disposições gerais aplicáveis do regulamento
  "declive": { "cota": 12.6, "declive_pct": 3.5, "declive_max_pct": 8.8, … },
  "api": { "cliente": "…", "uso_hoje": 12, "quota_dia": 25, "termos": "…" }
}

Erros

código	significado
401	chave em falta, inválida ou desconhecida
422	anel inválido, ou concelho não determinável (juntar `&dico=`)
429	quota diária esgotada — o contador reinicia às 00:00 UTC
400/500	erros da própria análise, com `{"erro": "…"}` explicativo

Cobertura e limites

Carta CRUS em 283 concelhos (os 278 do continente e 5 dos Açores); regulamento extraído em 219 (nos restantes a resposta traz a categoria de solo com regra: null). RAN de alta resolução em 270 concelhos e REN em 212, a crescer. Contagens de 22.10.2026. O campo api.uso_hoje devolve o consumo do dia em cada resposta.

Análise automática indicativa e não vinculativa — não substitui a informação prévia municipal nem parecer técnico. Dados de base: DGT (CRUS, Cadastro Predial) e DGADR (RAN), licença CC-BY 4.0 — a atribuição «Fonte: DGT/DGADR via pdm.xyzbim.eu» é obrigatória em produtos que exponham estes dados.

Agentes de IA (MCP), sem chave

Para ligar a consulta a um assistente com ferramentas (Claude, ChatGPT, Cursor e outros clientes MCP):

https://pdm.xyzbim.eu/mcp

Servidor MCP remoto (Streamable HTTP), sem autenticação. Duas ferramentas: pdm_terreno (latitude e longitude: concelho, categoria de solo, edificável, índice, pisos, artigos, RAN e REN) e pdm_concelho (nome ou código DICO: categorias do PDM com os mesmos campos). Cada resposta traz a ligação para a análise completa e conta para o limite da consulta gratuita (5 terrenos por dia). Altura, ocupação, área mínima, usos e condições ficam na análise completa e na API. Cartão do servidor: /.well-known/mcp/server-card.json; catálogo de APIs: /.well-known/api-catalog; especificação da API: openapi.json; privacidade.

Acesso e preço

Plano	Preço	Análises	Para quem
Gabinete	49 €/mês + IVA	25 por dia	Um gabinete de arquitetura, engenharia ou avaliação imobiliária.
Profissional	149 €/mês + IVA	150 por dia	Equipas e promotores com vários projetos em simultâneo.
Portal ou empresa	desde 490 €/mês + IVA	1 000 por dia	Portais imobiliários e integração num produto. Contrato anual; campos à medida, lotes, CSV e webhooks a combinar.

Os resultados são para usar no vosso trabalho ou produto. A cópia, revenda ou redistribuição em bloco dos dados (regulamentos extraídos, categorias, parâmetros) não está incluída em nenhum plano.

Sem chave, a consulta no mapa é gratuita até 5 terrenos por dia.

Pedir chave de API

A chave segue por email no próprio dia útil, com fatura. Sem instalação: é um URL.