شارك المقالة
شرح Dictionary وJSON في Python مع مثال بيانات الطقس

شرح Dictionary وJSON في Python مع مثال بيانات الطقس

شرح Dictionary وJSON في Python: المفاتيح والقيم وget وitems والبيانات المتداخلة، مع مثال طقس محلي وطلب اختياري عبر HTTPS دون…

شرح Dictionary وJSON في Python يبدأ بقاموس يحتوي مفاتيح وقيمًا، وبنص JSON يمثل بيانات قابلة للتبادل. يحول json.loads النص إلى كائنات Python، بينما يحول json.dumps الكائن المدعوم إلى نص JSON. ليست كل صيغة مطبوعة لقاموس JSON صالحًا؛ توجد فروق في علامات الاقتباس والقيم المنطقية وnull. سنقرأ مثال طقس محليًا ثم نوضح كيف يمكن فصل جلب البيانات عن تحليلها دون تضمين مفتاح خدمة في المقال.

التجهيز والتشغيل

استخدم Python 3.9 أو أحدث واحفظ المثال في ملف مستقل خارج مجلد مكتبات Python.

python lesson_25584.py
# Optional HTTP helper dependency:
python -m pip install requests

المفاتيح والقيم والبحث المباشر

data["name"] يطلب مفتاحًا موجودًا ويرفع KeyError عند غيابه، بينما get يسمح بقيمة افتراضية. تستخدم keys لأسماء المفاتيح وvalues للقيم وitems للزوج معًا. المرور على القاموس نفسه يعطي المفاتيح، وليس القيمة تلقائيًا. لا تجعل القيمة الافتراضية تخفي نقص حقل مطلوب؛ اسم المدينة يمكن عرضه Unknown في مثالنا، لكن درجة الحرارة غير الموجودة ترفض بدل تحويلها إلى صفر يوحي بقراءة طقس حقيقية.

البيانات المتداخلة وفحص النوع

تقع درجة الحرارة داخل data["main"]["temp"]. تفحص summarize_weather وجود المسار ثم نوع القيمة وأنها عدد محدود. لا يكفي نجاح json.loads لأن JSON قد يمثل قائمة أو قاموسًا بأسماء مختلفة أو temp كنص. نرفض bool أيضًا كي لا تتحول True إلى درجة حرارة عددية في الحسابات. يعيد التحليل قاموسًا صغيرًا واضح الحقول يمكن أن تستعمله واجهة أو اختبار دون معرفة تفاصيل طلب الشبكة.

المثال البرمجي الكامل

import json
import math
import os

def summarize_weather(data):
    try:
        temperature = data["main"]["temp"]
    except (KeyError, TypeError) as error:
        raise ValueError("Missing main.temp in weather JSON") from error
    if isinstance(temperature, bool) or not isinstance(temperature, (int, float)) or not math.isfinite(temperature):
        raise ValueError("Temperature must be a finite number")
    return {"city": data.get("name", "Unknown"), "temperature_c": temperature}

def fetch_weather(city, api_key=None):
    import requests
    key = api_key or os.environ.get("OPENWEATHER_API_KEY")
    if not key:
        raise ValueError("Set OPENWEATHER_API_KEY locally")
    response = requests.get(
        "https://api.openweathermap.org/data/2.5/weather",
        params={"q": city, "appid": key, "units": "metric"}, timeout=15)
    response.raise_for_status()
    return summarize_weather(response.json())

if __name__ == "__main__":
    # Offline example: no network request or real API key.
    raw = '{"name":"Demo City","main":{"temp":24.5}}'
    data = json.loads(raw)
    print(list(data.keys()))
    print(data.get("missing", "Default value"))
    print(summarize_weather(data))
    print(json.dumps(data, ensure_ascii=False, indent=2))
    # Optional after configuring your own account:
    # print(fetch_weather("Cairo"))

المثال المحلي هو نقطة البداية

عند تشغيل الملف يستخدم نص JSON مصطنعًا باسم Demo City ودرجة 24.5، ولا يرسل طلبًا خارجيًا. يطبع المفاتيح وقيمة get الافتراضية وملخص البيانات والنص المنسق. ensure_ascii=False يبقي الحروف العربية مقروءة في نص JSON الناتج، لكنه لا يختار ترميز الملف عند الكتابة؛ حدد UTF-8 في open عند حفظه. هذه التجربة تفصل مشكلة التعامل مع القاموس عن مشكلة حساب خدمة أو اتصال أو حصة طلبات.

طلب طقس اختياري دون مفتاح في المصدر

تقرأ fetch_weather المفتاح من OPENWEATHER_API_KEY أو وسيط يمرره تطبيقك، ثم تستخدم HTTPS وparams وtimeout. اسم المعامل الصحيح للمفتاح appid، وتحدد units=metric طلب درجات مئوية بدل طرح قيمة تقريبية من كلفن دون توضيح. لا تعيد استخدام المفتاح الذي كان منشورًا في نسخة قديمة من المثال، ولا تختبر صلاحيته. جهز حسابك وإعداداتك الخاصة وفق توثيق الخدمة قبل تشغيل مسار الشبكة الاختياري.

أخطاء HTTP وJSON لا تختفي بالتحويل

تستدعي raise_for_status قبل التحليل حتى لا تعتبر استجابة خطأ بيانات طقس صحيحة. قد يحدث فشل شبكة أو مهلة أو JSON غير صالح أو حقل ناقص، ولكل منها مرحلة مختلفة في المعالجة. لا تطبع عنوان طلب كاملًا إذا كان يتضمن مفتاح API ضمن المعلمات، ولا تعرض الاستثناء الخام للمستخدم دون مراجعة البيانات الحساسة. حدود الاستعمال وتفعيل المفتاح تتبع إعداد الخدمة وحسابك، وليست جزءًا يضمنه هذا السكربت.

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

إضافة data["unit"] = "C" تغير القاموس الموجود، أما إنشاء قاموس ناتج جديد كما في summarize_weather فيفصل الشكل الذي يحتاجه المستدعي. dict.copy ينسخ الطبقة الأولى فقط؛ القواميس الداخلية قد تبقى مشتركة. عندما تختبر تعديلًا على main انتبه لهذه العلاقة، ولا تفترض أن اسم متغير جديد يعني نسخة مستقلة لكل المستويات. راجع البيانات قبل وبعد العملية بدل الاكتفاء بطباعة ناتج واحد.

اختبارات قبل ربطه بواجهة

جرب JSON صالحًا ثم main مفقودة وtemp كنص أو قيمة غير محدودة في كائن Python. اختبر اسم مدينة عربيًا وحفظ النص وقراءته. لطلب الشبكة يمكن استخدام رد تجريبي يفحص appid وunits والمهلة دون بيانات اعتماد حقيقية. نجاح هذه الاختبارات يثبت مسار البيانات في المثال، لكنه لا يثبت تفعيل مفتاح أو توفر الخدمة لحسابك. حافظ على الفصل بين جلب الاستجابة وتحليل القاموس حتى تعيد استخدام التحليل دون شبكة.

المراجع

هياكل بيانات Python

إعداد الطلب الاختياري موضح في توثيق OpenWeather الرسمي.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

طباعة عناصر من داخل Json و معرفة عدد العناصر الموجوده بداخل dictionary بلغة python كيفية استخدام api داخل لغة بايثون معرفة key و valuues للقاموس الموجود في بايثون ! معرفة بيانات معينة من داخل dictionary في python كيفية فصل العناصر الموجوده داخل القاموس في بايثون
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع