توثيق بوابة اوقات الصلاة

مقدمة

تعد خدمة أوقات الصلاة إحدى خدمات دار الإسلام الجديدة والتي قامت بتطوريها نظرا لعدم وجود خدمة مشابه مخصصة للمطورين وليس للمستخدم العادي حيث تتيح الخدمة الحصول على أوقات الصلاة بسهولة لأي تاريخ او فترة زمنية وعرضها بصيغة json وهي صيغة يسهل للمبرمجين التعامل معها وإستخدامها في تطبيقاتهم او انشاء نوافذ لعرض اوقات الصلاة للمستخدم حسب دولته

هناك عدة طرق مختلفة لحساب مواقيت الصلاة وهي متشابهة في اغلب المواقيت ماعدى المغرب والعشاء والفجر في الغالب حيث كل دولة او مجموعة دول تعتمد طريقة معينة في الحساب وفي الدول العربية الإختلاف بين الطرق ليس كبير جدا بين ١٠ الي ٣٠ دقيقة وكلما اقتربنا من خط الإستواء فإن الفرق يقل ولكن في أماكن مثل أمريكا وشمال أوربا فالإختلاف كبير لذلك يجب الإنتباه إلى الطريقة المستخدمه في الحساب وتنبيه المستخدم لها

ملاحظة

في بعض الدول يتم تغيير التوقيت خلال العام فمثلا في دولة مثل مصر هناك توقيت صيفي وشتوي مما يجعل المنطقة الزمنية في بعض الأوقات +2 وفي التوقيت الصيفي تكون +3

لكي تستطيع الحصول على مواقيت الصلاة ليوم معين او فترة زمنية او بين تاريخين محددين يجب أن يكون لديك ٣ بيانات تحصل عليها من جهاز المستخدم

خط الطول
دائرة العرض
الخط الزمني

طرق الحساب

للحصول على الطرق ورموزها وأسماؤها يمكنك طلبها من خلال هذا الرابط
http://api.islamhouse.com/v1/XXXXXX/services/praytime/get-methods/json
فيكون الناتج
MWL: Muslim World League
ISNA: Islamic Society of North America
Egypt: Egyptian General Authority of Survey
Makkah: Umm al-Qura University, Makkah
Karachi: University of Islamic Sciences, Karachi
Tehran: Institute of Geophysics, University of Tehran
حيث يتم ادخال طريقة الحساب في الرابط في كل مرة

أمثله عملية

للحصول على مواقيت الصلاة في تاريخ محدد مثلا 2014/08/13 بطريقة أم القرى
http://api.islamhouse.com/v1/XXXXXXXXX/services/praytime/get-times/2014/08/13/Makkah/30.0599153/31.2620199/+3/json
والتكويرن البرمجي للرابط هو
services/praytime/get-times/{year}/{month}/{day}/{method}/{latitude}/{longtude}/{timezone}/{format}

- يلاحظ أن طريقة الحساب هي أم القرى ويرمز إليها ب Makkah
- الخط الزمني هو +3
- ​خط الطول هو 30.0599153
-​ دائرة العرض هي 31.2620199 ​​
- ​نوع البيانات المطلوبة هي json data وهي المعتمدة الآن

لتكون النتجية

{
    date: "2014-08-13",
    method: "Makkah: Umm al-Qura University, Makkah",
    latitude: "30.0599153",
    longtude: "31.2620199",
    timezone: "+3",
    times: [
    "04:52",
    "06:21",
    "13:00",
    "16:36",
    "19:38",
    "19:38",
    "21:08"
    ]
}

توضيح

ترتيب عرض أوقات الصلاة يكون
( الفجر - شروق الشمس - الظهر - العصر - غروب الشمس - المغرب - العشاء )

للحصول على مواقيت الصلاة لتاريخ اليوم يمكن طلبها من الرابط
http://api.islamhouse.com/v1/XXXXXXXXXX/services/praytime/get-times/Makkah/30.0599153/31.2620199/+3/json
يلاحظ انه تم حذف اي تاريخ

للحصول على أوقات الصلاة لمدة شهر كامل على سبيل المثال شهر ٦

http://api.islamhouse.com/v1/XXXXXXXXXX/services/praytime/get-times/2014/06/Makkah/30.0599153/31.2620199/+3/json

يلاحظ تم تحديد الشهر والسنة وعدم وضع اليوم

للحصول على مواقيت الصلاة لعام كامل يمكن من خلال الرابط

http://api.islamhouse.com/v1/XXXXXXXXXX/services/praytime/get-times/2014/Makkah/30.0599153/31.2620199/+3/json
يلاحظ انه تم حذف اليوم والشهر وترك العام

للحصول على مواقيت الصلاة بين تاريخين محددين من خلال الرابط

http://api.islamhouse.com/v1/XXXXXXXXXX/services/praytime/get-times/2014-03-14/2014-09-20/Makkah/30.0599153/31.2620199/+3/json