Evitalya API · v1

İtalya'daki her adres için yaşanabilirlik puanı

Tek bir HTTP çağrısı: İtalya'daki herhangi bir adres için 111 metrikten hesaplanan puan — güvenlik, hizmetler, ulaşım, çevre, gayrimenkul ve doğal riskler. Ulusal kapsam, kurumsal kaynaklar (ISTAT, ARPA, ISPRA, INGV, OMI, AGENAS), ticari kullanıma açık lisanslar.

Kimin için

Emlak danışmanları ve acenteler

Portföydeki her adresi tek çağrıyla puanlayın; puanı ve altı kategoriyi ilan dosyasına koyun. Müşteri «bu mahalle nasıl» diye sorduğunda cevap resmî veriye dayanır, kanaate değil.

Relokasyon ve göçmenlik danışmanları

Bir aile gelmeden önce aday adresleri karşılaştırın: okul, sağlık, ulaşım, güvenlik ve doğal risk aynı ölçekte. insufficient_data alanı «kötü» ile «ölçülmedi»yi ayırır — bir tavsiye verirken fark budur.

Portallar ve yazılım

İlan sayfasına adres bazlı puan ekleyin. Yanıt kod döndürür (safety, enviro), etiket değil: site dili değişse de entegrasyonunuz kırılmaz. Kota aylıktır, gece çalışan bir içe aktarma tek seferde tüketebilir.

Fiyatlar

Sözleşme yok, görüşme yok, minimum süre yok. Ücretsiz plan hemen başlar ve kart istemez: hesabınızdan anahtarınızı alıp çağırmaya başlarsınız. Ücretli planları hesabınızdan kredi kartıyla başlatırsınız ve aynı yerden iptal edersiniz. Fiyatlar aylıktır ve KDV, tarafımızda uygulanan vergi rejimine göre hesaplanır.

Beş dakikada başlayın

Hesap açın, e-postanızı doğrulayın, hesabınızdan anahtarınızı alın. Ücretsiz plan kart istemez.

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

Neden insufficient_data önemli: düşük bir puan, yerin kötü olduğu anlamına da gelebilir, o kategoriyi ölçecek verinin bulunmadığı anlamına da. Bu alan ikisini ayırır — bir değerleme uzmanı için farkı budur.

Yanıtlar

Kod	Anlamı
`200`	Puan hesaplandı.
`401`	Anahtar yok, geçersiz veya iptal edilmiş.
`404`	`address_not_found` — adres coğrafi olarak çözülemedi.
`429`	`monthly_quota_exceeded` — aylık kotanız doldu.
`502`	Coğrafi çözümleme servisi geçici olarak kullanılamıyor.

Bilmeniz gerekenler

Kota aylıktır, günlük değil: gece çalışan bir içe aktarma ya da bir portföyün yeniden hesaplanması tek seferde tüketilebilir.
Kategori anahtarları koddur (safety, enviro), etiket değil. Site dili değişse de entegrasyonunuz kırılmaz.
Anahtar bir kez gösterilir. Sunucu yalnızca özetini saklar.
Aboneliğinizi iptal ederseniz anahtar çalışmaya devam eder, ücretsiz plan sınırında. Entegrasyonunuzu habersiz kırmayız.

Ne yapabilirsiniz: aktif bir planla aldığınız puanları kendi ürününüzde ve müşterinize teslim ettiğiniz belgelerde yayımlayabilirsiniz; atıf zorunludur. Ayrıntı: Koşullar, 21. madde.

Makineler için: OpenAPI tanımı ve JSON listesi.

Ücretsiz başla