Evitalya API · v1
طلب HTTP واحد: درجة تُحتسب من 111 مؤشرًا لأي عنوان في إيطاليا — الأمان والخدمات والتنقل والبيئة والعقارات والمخاطر الطبيعية. تغطية وطنية، ومصادر رسمية (ISTAT، ARPA، ISPRA، INGV، OMI، AGENAS)، وتراخيص تسمح بالاستخدام التجاري.
قيّم كل عنوان في محفظتك بطلب واحد، وضع الدرجة والفئات الست في صفحة الإعلان. وحين يسأل العميل «كيف هذا الحي؟» يكون الجواب مستندًا إلى بيانات رسمية لا إلى رأي.
قارن بين العناوين المرشّحة قبل وصول الأسرة: المدارس والصحة والنقل والأمان والمخاطر الطبيعية على المقياس نفسه. ويفصل حقل insufficient_data بين «سيّئ» و«غير مقيس» — وهو الفارق كله عند تقديم نصيحة.
أضف إلى صفحات إعلاناتك درجة على مستوى العنوان. تعيد الاستجابة رموزًا (safety، enviro) لا تسميات: فلا يتعطّل تكاملك عند تغيّر لغة الموقع. والحصة شهرية، لذا قد يستهلكها استيراد ليلي دفعة واحدة.
بلا عقد، وبلا مفاوضة، وبلا حد أدنى للمدة. تبدأ الخطة المجانية فورًا ولا تطلب بطاقة: خذ مفتاحك من حسابك وابدأ الاستدعاء. وتُفعَّل الخطط المدفوعة من حسابك ببطاقة ائتمان وتُلغى من المكان نفسه. الأسعار شهرية، وتُحتسب ضريبة القيمة المضافة وفق نظامنا الضريبي.
أنشئ حسابًا، وأكّد بريدك الإلكتروني، ثم خذ مفتاحك من حسابك. الخطة المجانية لا تطلب بطاقة.
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": []
}لماذا يهمّ insufficient_data: قد تعني الدرجة المنخفضة أن المكان سيّئ، وقد تعني أنه لا توجد بيانات لقياس تلك الفئة. ويفصل هذا الحقل بين الأمرين — وهو بالنسبة إلى مُقيّم الفارق كله.
| الرمز | المعنى |
|---|---|
200 | تم احتساب الدرجة. |
401 | المفتاح مفقود أو غير صالح أو مُلغى. |
404 | address_not_found — تعذّر تحديد موقع العنوان. |
429 | monthly_quota_exceeded — استُنفدت حصتك الشهرية. |
502 | خدمة الترميز الجغرافي غير متاحة مؤقتًا. |
safety، enviro) لا تسميات. فلا يتعطّل تكاملك عند تغيّر لغة الموقع.ما يمكنك فعله: مع خطة فعّالة يمكنك نشر الدرجات التي تحصل عليها في منتجك وفي المستندات التي تسلّمها لعميلك، والإسناد إلزامي. التفاصيل: الشروط، البند 21.
للأنظمة الآلية: وصف OpenAPI والخطط بصيغة JSON.