تخطي إلى المحتوى
POST AI agent ready /v1/weather/current

واجهة برمجة تطبيقات الطقس - الظروف الحالية حسب المدينة أو الإحداثيات

إرجاع بيانات الطقس الحالية لموقع محدد باسم المدينة أو خط العرض/خط الطول. تتضمن الاستجابة درجة الحرارة (مع الشعور)، والرطوبة، وهطول الأمطار، وسرعة الرياح واتجاهها، والغطاء السحابي، ورمز الطقس الرقمي، ووصف يمكن قراءته بواسطة الإنسان.

Parameters

string

City name to look up weather for. Provide either city or lat/lng.

number

Latitude of the location. Use with lng.

number

Longitude of the location. Use with lat.

Code examples

curl -X POST https://api.botoi.com/v1/weather/current \
  -H "Content-Type: application/json" \
  -d '{"city":"London","lat":51.5074,"lng":-0.1278}'

When to use this API

محتوى ديناميكي يعتمد على الطقس المحلي

قم بتخصيص لافتات الصفحة الرئيسية أو توصيات المنتج بناءً على الطقس المحلي للزائر. يمكن لموقع البيع بالتجزئة الترويج للمظلات عند هطول الأمطار أو الواقي من الشمس أثناء السماء الصافية، مما يؤدي إلى زيادة معدلات التحويل مع ملاءمة السياق.

اللوجستية وتخطيط طريق التسليم

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

إنترنت الأشياء وأتمتة المنزل الذكي

استطلاع بيانات الطقس الحالية لتحفيز إجراءات المنزل الذكي. أغلق الستائر الآلية عندما تنخفض نسبة الغطاء السحابي إلى أقل من 20%، وقم بتنشيط الرشاشات فقط عندما يكون هطول الأمطار صفرًا، أو اضبط نقاط ضبط منظم الحرارة بناءً على درجة الحرارة التي تشعر بها.

Frequently asked questions

هل يجب علي استخدام اسم المدينة أو الإحداثيات؟
إما يعمل. اسم المدينة مناسب للمدخلات التي تواجه المستخدم. تكون الإحداثيات أكثر دقة وتتجنب الغموض عندما تشترك عدة مدن في نفس الاسم (على سبيل المثال، يوجد "سبرينغفيلد" في أكثر من 30 ولاية أمريكية).
ما هي وحدة درجة الحرارة التي يتم إرجاعها؟
يتم إرجاع درجات الحرارة بالدرجة المئوية افتراضيًا. يؤكد حقل الوحدة في الرد ذلك. قم بالتحويل إلى درجة فهرنهايت من جانب العميل باستخدام الصيغة F = C * 9/5 + 32.
كم مرة يتم تحديث بيانات الطقس؟
يتم تحديث بيانات الطقس كل 15 دقيقة من مصادر المنبع. بالنسبة لمعظم التطبيقات، يعد تخزين الاستجابات مؤقتًا لمدة تتراوح بين 10 و15 دقيقة من جانبك أمرًا آمنًا ويقلل من استدعاءات واجهة برمجة التطبيقات (API).
ماذا يمثل حقل Weather_code؟
رمز Weather_code هو رمز رقمي لتفسير الطقس تابع للمنظمة (WMO). القيم المشتركة: 0 = سماء صافية، 1-3 = غائم جزئياً، 45/48 = ضباب، 51-67 = رذاذ/مطر، 71-77 = ثلج، 80-82 = زخات مطر، 95+ = عاصفة رعدية. يوفر حقل الوصف تسمية يمكن قراءتها بواسطة الإنسان.
ماذا يحدث إذا لم يتم توفير المدينة أو الإحداثيات؟
تعرض نقطة النهاية خطأً يطلب منك تقديم اسم مدينة أو زوج من خطوط العرض/الخط الطولي. مطلوب معلمة موقع واحدة على الأقل.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs