Evitalya API · v1

Uma pontuação de qualidade de vida para cada endereço na Itália

Uma única chamada HTTP: uma pontuação calculada a partir de 111 métricas para qualquer endereço na Itália — segurança, serviços, transporte, meio ambiente, mercado imobiliário e riscos naturais. Cobertura nacional, fontes oficiais (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), licenças abertas ao uso comercial.

Para quem é

Imobiliárias e consultores imobiliários

Você atribui uma pontuação a cada endereço da carteira com uma única chamada e coloca a pontuação e as seis categorias na página do anúncio. Quando o cliente pergunta “como é esta área”, a resposta se baseia em dados oficiais, não em uma opinião.

Relocation e consultores de expatriação

Você compara os endereços cogitados antes que uma família chegue: escolas, saúde, transporte, segurança e risco natural na mesma escala. O campo insufficient_data separa “ruim” de “não medido” — o que faz toda a diferença na hora de fazer uma recomendação.

Portais e software

Adicione às páginas de anúncio uma pontuação por endereço. A resposta retorna códigos (safety, enviro), não rótulos: a integração não quebra quando o idioma do site muda. A cota é mensal, então uma importação noturna pode consumi-la de uma vez.

Preços

Sem contrato, sem negociação, sem fidelidade. O plano gratuito começa na hora e não pede cartão: você pega a chave na sua conta e já pode fazer chamadas. Os planos pagos são ativados na sua conta com cartão de crédito e são cancelados no mesmo lugar. Os preços são mensais; o IVA é aplicado de acordo com nosso regime fiscal.

Começar leva cinco minutos

Crie uma conta, verifique seu e-mail, pegue a chave na sua conta. O plano gratuito não pede cartão.

curl -X POST https://evitalya.com/v1/score \
  -H "x-api-key: ev_pro_..." \
  -H "content-type: application/json" \
  -d '{"address": "Via Vigevano 12, Milano"}'

{
  "schema": "evitalya.score.v1",
  "plan": "pro",
  "address": { "resolved": "Via Vigevano 12, Milano", "istat": "015146",
               "comune": "Milano", "provincia": "MI" },
  "score": 72.4,
  "reliability": 0.91,
  "reliability_code": "high",
  "categories": {
    "safety":       { "score": 68.2, "reliability": 0.88 },
    "services":     { "score": 79.5, "reliability": 0.93 },
    "mobility":     { "score": 84.1, "reliability": 0.90 },
    "enviro":       { "score": 61.7, "reliability": 0.95 },
    "realestate":   { "score": 70.3, "reliability": 0.87 },
    "natural_risk": { "score": 88.0, "reliability": 0.96 }
  },
  "measured_metrics": 104,
  "total_metrics": 111,
  "insufficient_data": []
}

Por que insufficient_data importa: uma pontuação baixa pode significar que o lugar é ruim ou que não havia dados para medir essa categoria. Este campo separa as duas coisas — e, para quem faz laudos de avaliação, isso faz toda a diferença.

Respostas

Código	Significado
`200`	Pontuação calculada.
`401`	Chave ausente, inválida ou revogada.
`404`	`address_not_found` — o endereço não foi geocodificado.
`429`	`monthly_quota_exceeded` — a cota mensal esgotou.
`502`	O serviço de geocodificação está temporariamente indisponível.

O que você precisa saber

A cota é mensal, não diária: uma importação noturna ou o recálculo de uma carteira de imóveis pode consumi-la de uma só vez.
As chaves das categorias são códigos (safety, enviro), não rótulos. A integração não quebra quando o idioma do site muda.
A chave é exibida uma única vez. O servidor armazena apenas a impressão digital dela.
Se você cancelar, a chave continua funcionando dentro do limite do plano gratuito. Não quebramos sua integração sem avisar.

O que você pode fazer: com um plano ativo, você pode publicar as pontuações que obtém no seu produto e nos documentos que entrega ao seu cliente; a atribuição é obrigatória. Detalhes: Termos, artigo 21.

Para máquinas: a descrição OpenAPI e a tabela de preços em JSON.

Começar grátis