Evitalya API · v1

Un scor de locuibilitate pentru fiecare adresă din Italia

Un singur apel HTTP: un scor calculat din 111 metrici pentru orice adresă din Italia — siguranță, servicii, transport, mediu, imobiliare și riscuri naturale. Acoperire națională, surse oficiale (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), licențe deschise utilizării comerciale.

Pentru cine este

Agenții și consultanți imobiliari

Atribui un scor fiecărei adrese din portofoliu cu un singur apel și pui scorul și cele șase categorii în pagina anunțului. Când clientul întreabă „cum e zona asta”, răspunsul se sprijină pe date oficiale, nu pe o opinie.

Relocare și consultanți pentru expatriere

Compari adresele candidate înainte ca o familie să sosească: școli, sănătate, transport, siguranță și risc natural pe aceeași scară. Câmpul insufficient_data separă „prost” de „nemăsurat” — și asta face toată diferența când dai un sfat.

Portaluri și software

Adaugă în paginile anunțurilor un scor la nivel de adresă. Răspunsul returnează coduri (safety, enviro), nu etichete: integrarea nu se strică atunci când se schimbă limba site-ului. Cota este lunară, așa că un import nocturn o poate consuma dintr-odată.

Prețuri

Fără contract, fără negocieri, fără durată minimă. Planul gratuit pornește imediat și nu cere card: iei cheia din contul tău și începi să faci apeluri. Planurile plătite se activează din contul tău cu cardul de credit și se anulează din același loc. Prețurile sunt lunare; TVA se aplică potrivit regimului nostru fiscal.

Se începe în cinci minute

Deschide un cont, verifică-ți adresa de e-mail, ia cheia din contul tău. Planul gratuit nu cere card.

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": []
}

De ce contează insufficient_data: un scor scăzut poate însemna că locul e urât sau că nu existau date pentru a măsura acea categorie. Acest câmp separă cele două situații — iar pentru cine face o expertiză, asta face toată diferența.

Răspunsuri

Cod	Semnificație
`200`	Scor calculat.
`401`	Cheie lipsă, nevalidă sau revocată.
`404`	`address_not_found` — adresa nu a fost geocodificată.
`429`	`monthly_quota_exceeded` — cota lunară este epuizată.
`502`	Serviciul de geocodificare este temporar indisponibil.

Ce trebuie să știi

Cota este lunară, nu zilnică: un import nocturn sau recalcularea unui portofoliu o poate consuma dintr-odată.
Cheile de categorie sunt coduri (safety, enviro), nu etichete. Integrarea nu se strică atunci când se schimbă limba site-ului.
Cheia se vede o singură dată. Serverul îi păstrează doar amprenta.
Dacă anulezi, cheia continuă să funcționeze la limita planului gratuit. Nu îți stricăm integrarea fără să te anunțăm.

Ce poți face: cu un plan activ poți publica scorurile pe care le obții în produsul tău și în documentele pe care le predai clientului tău; menționarea sursei este obligatorie. Detalii: Termeni și condiții, articolul 21.

Pentru programe: descrierea OpenAPI și lista de prețuri în JSON.

Începe gratuit