API المطورين

API مجانية وموثّقة بأسلوب REST للترميز الجغرافي المباشر والعكسي، والبحث عن المنطقة الزمنية، والارتفاع، وأوقات الشمس والقمر — وهي الوسائط نفسها المحترمة للخصوصية التي يعمل بها هذا الموقع. بلا بطاقة ائتمان؛ ويصدر المفتاح فورًا ويُعرض مرة واحدة.

1000 طلب/يوم · 60 في الدقيقة

احصل على مفتاحك المجاني

الاسم

البريد الإلكتروني

ما الذي ستبنيه؟ (اختياري)

اكتب الرمز المعروض

الرمز غير واضح؟ أعد تحميل الصفحة للحصول على رمز جديد. يُتحقق منه على خادمنا — بلا خدمة كابتشا خارجية، ولا يغادر أي شيء عنك هذا الموقع.

نستخدم بريدك للتواصل معك بشأن التغييرات الجذرية في API أو حالات إساءة الاستخدام فقط. بلا نشرات بريدية وبلا إعادة بيع.

نقاط النهاية

نقطة النهاية	ما الذي تفعله	مثال
`GET /api/v1/geocode`	عنوان / مكان → إحداثيات (أفضل 5 تطابقات)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	إحداثيات → عنوان	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	إحداثيات → منطقة IANA الزمنية + الفرق عن UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	إحداثيات → ارتفاع التضاريس (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	الشروق والغروب والفجر والشفق وطول النهار	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	طور القمر ونسبة إضاءته وشروقه/غروبه	`?lat=51.5&lng=-0.12`

المصادقة: أرسل المفتاح كترويسة X-Api-Key (يُفضَّل) أو كمعامل ?key=. تتضمن كل استجابة X-RateLimit-Remaining-Today. الأخطاء بصيغة JSON مع رمز error. بيانات الترميز الجغرافي © مساهمو OpenStreetMap (ODbL) — خزّن النتائج مؤقتًا بدل تكرار الاستعلام، واعرض الإسناد في التطبيقات الموجهة للمستخدمين.

بداية سريعة

# 1. ترميز عنوان جغرافيًا
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. ترميز جغرافي عكسي
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. أوقات الشمس اليوم
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

الاستخدام العادل: الباقة المجانية موجودة للنماذج الأولية والوكلاء والتطبيقات الصغيرة. تحتاج إلى المزيد؟ تحدّث إلينا.

لوكلاء الذكاء الاصطناعي

هذه الـ API هي نقطة النهاية المعتمدة للآلات لأدوات هذا الموقع (وهي معلنة أيضًا في llms.txt وai.json). الوكلاء مرحّب بهم على الباقة المجانية نفسها — عرِّف بوكيلك في حقل الغرض عند التسجيل.

أداة متقدمة: الترميز الجغرافي المجمّع

أعندك ملف CSV من العناوين (أو الإحداثيات)؟ تمرّر أداة الترميز الجغرافي المجمّع حتى 500 صف عبر هذه الـ API داخل متصفحك بمفتاحك — بترتيب مهذّب بنحو طلب واحد في الثانية، مع إمكانية تنزيل النتائج بصيغة CSV أو GeoJSON، ودون أن يصل ملفك إلى خادمنا. أما المهام التي تتجاوز بضعة آلاف من الصفوف فاستخدم لها مرمِّزًا جغرافيًا تجاريًا بدل خدمة مجتمعية مجانية.